List cards

List all the active cards associated with a Moov account. Read our accept card payments guide to learn more.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/cards.read scope when generating a token.

GET

/accounts/{accountID}/cards

cURL Go JavaScript

1
2


curl -X GET "https://api.moov.io/accounts/{accountID}/cards" \
  -H "Authorization: Bearer {token}" \

1
2
3
4
5


mc, _ := moov.NewClient()

var accountID string

mc.ListCards(ctx, accountID)

1
2
3


const moov = new Moov(credentialsObject);

moov.cards.list(accountID)

200 404 429

Successfully retrieved cards.

[
  {
    "billingAddress": {
      "addressLine1": "123 Main Street",
      "addressLine2": "Apt 302",
      "city": "Boulder",
      "country": "US",
      "postalCode": "80301",
      "stateOrProvince": "CO"
    },
    "bin": "123456",
    "brand": "Discover",
    "cardAccountUpdater": {
      "updateType": "number-update",
      "updatedOn": "2019-08-24T14:15:22Z"
    },
    "cardCategory": "CLASSIC",
    "cardID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "cardOnFile": true,
    "cardType": "debit",
    "cardVerification": {
      "accountName": {
        "firstName": "match",
        "fullName": "match",
        "lastName": "match",
        "middleName": "match"
      },
      "addressLine1": "match",
      "cvv": "match",
      "postalCode": "match"
    },
    "commercial": true,
    "domesticPullFromCard": "supported",
    "domesticPushToCard": "fast-funds",
    "expiration": {
      "month": "01",
      "year": "21"
    },
    "fingerprint": "9948962d92a1ce40c9f918cd9ece3a22bde62fb325a2f1fe2e833969de672ba3",
    "holderName": "Jules Jackson",
    "issuer": "GRINGOTTS BANK",
    "issuerCountry": "US",
    "issuerPhone": "8185551212",
    "issuerURL": "HTTPS://WWW.EXAMPLE.COM/",
    "lastFourCardNumber": "1234",
    "merchantAccountID": "50469144-f859-46dc-bdbd-9587c2fa7b42",
    "paymentMethods": [
      {
        "paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
        "paymentMethodType": "card-payment"
      },
      {
        "paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
        "paymentMethodType": "push-to-card"
      }
    ],
    "regulated": true
  }
]

No account with the specified accountID was found.

Request was refused due to rate limiting.

Retry-After


      number

Path parameters

accountID


      string
      <uuid>

required

ID of the Moov account representing the cardholder.

Response

application/json

billingAddress


        object

Show child attributes

addressLine1


        string

<=60 characters required

city


        string

<=24 characters required

country


        string

<=2 characters required

postalCode


        string

<=5 characters required

stateOrProvince


        string

<=2 characters required

addressLine2


        string

<=32 characters

bin


        string

The first six to eight digits of the card number, which identifies the financial institution that issued the card.

brand


              string

The card brand.

Possible values: American Express, Discover, Mastercard, Visa

cardAccountUpdater


        object

The results of the most recent card update request.

Show child attributes

updateType


        string<enum>

The results of the card update request.

Possible values: unspecified, account-closed, contact-cardholder, expiration-update, no-change, no-match, number-update

updatedOn


        string<date-time>

<=24 characters

cardCategory


        string

The category or level of the card defined by the issuer. Examples include, but not limited to “REWARDS”, “TRADITIONAL REWARDS”, “CLASSIC”, and “CORPORATE PURCHASING”.

cardID


        string<uuid>

<=36 characters

UUID v4

cardOnFile


        boolean

Indicates cardholder has authorized card to be stored for future payments.

cardType


        string<enum>

The type of the card.

Possible values: debit, credit, prepaid, unknown

cardVerification


              object

The results of submitting cardholder data to a card network for verification.

Show child attributes

accountName


              object

The results of submitting cardholder name to a card network for verification.

Show child attributes