Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. API reference
  2. Money movement
  3. Card issuing

List spending cards

List Moov issued cards existing for the account.

All supported query parameters are optional.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/issued-cards.read scope when generating a token.
GET
/issuing/{accountID}/issued-cards
cURL 
1
2

curl -X GET "https://api.moov.io/issuing/{accountID}/issued-cards" \
  -H "Authorization: Bearer {token}" \
200 404 429
Successfully retrieved cards.
[
  {
    "authorizedUser": {
      "firstName": "Jane",
      "lastName": "Doe"
    },
    "brand": "Discover",
    "controls": {
      "singleUse": false,
      "velocityLimits": [
        {
          "amount": 10000,
          "interval": "per-transaction"
        }
      ]
    },
    "createdOn": "2019-08-24T14:15:22Z",
    "expiration": {
      "month": "01",
      "year": "21"
    },
    "formFactor": "virtual",
    "fundingWalletID": "string",
    "issuedCardID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
    "lastFourCardNumber": "1234",
    "memo": "string",
    "state": "active"
  }
]
No account with the specified accountID was found.
Request was refused due to rate limiting.

Response headers

Retry-After

number

Path parameters

accountID

string <uuid> required
ID of the account.

Query parameters

states

string
Optional, comma-separated states to filter the Moov list issued cards response. For example active,pending-verification
Possible values: active, inactive, pending-verification, closed

count

integer
Optional parameter to limit the number of results in the query.
Default: 200

skip

integer
The number of items to offset before starting to collect the result set.

Response

application/json

authorizedUser

object
Fields for identifying an authorized individual.
right_key Show child attributes

firstName

string

lastName

string

brand

string<enum>
The card brand.
Possible values: American Express, Discover, Mastercard, Visa

controls

object
right_key Show child attributes

singleUse

boolean
Indicates if the card is single-use. If true, the card closes after the first authorization.

velocityLimits

array
Sets the spending limit per time interval. Only one limit per interval is supported.
right_key Show child attributes

amount

integer
The maximum amount in cents that can be spent in a given interval.

interval

string<enum>
Specifies the time frame for the velocity limit. Currently supports only per-transaction limits.
Possible values: per-transaction

createdOn

string<date-time> <=24 characters

expiration

object
The expiration date of the card or token.
right_key Show child attributes

month

string 2 characters

year

string 2 characters

formFactor

string<enum>
Specifies the type of spend card to be issued. Presently supports virtual only, providing a digital number without a physical card.
Possible values: virtual

fundingWalletID

string
Unique identifier for the wallet funding the card.

issuedCardID

string<uuid> <=36 characters
UUID

lastFourCardNumber

string

memo

string
Optional descriptor for the card.

state

string<enum>

The state represents the operational status of an issued card. A card can only approve incoming authorizations if it is in an active state.

  • active: The card is operational and approves authorizations. Generally becomes active shortly after card creation.
  • inactive: The card cannot approve authorizations. This is currently a temporary state assigned post-creation during the activation process.
  • closed: The card is permanently deactivated and cannot approve authorizations. A card can be closed by request or when it expires.
  • pending-verification: Awaiting additional authorized user verification before the card can be activated.
Possible values: active, inactive, pending-verification, closed