GET
/
cards
List Cards
curl --request GET \
  --url https://api.synctera.com/v1/cards \
  --header 'Authorization: Bearer <token>'
{
  "next_page_token": "a8937a0d",
  "cards": [
    {
      "card_details": {
        "account_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "business_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "card_product_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "creation_time": "2010-05-06T12:23:34.321Z",
        "customer_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "emboss_name": {},
        "expiration_month": "06",
        "expiration_time": "2010-05-06T12:23:34.321Z",
        "expiration_year": "25",
        "id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "is_pin_set": true,
        "last_four": "1234",
        "last_updated_time": "2010-05-06T12:23:34.321Z",
        "metadata": {},
        "reissue_reason": "APPEARANCE",
        "reissued_from_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "reissued_to_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "timestamp_pin_set": "2010-05-06T12:23:34.321Z",
        "form": "PHYSICAL",
        "bulk_order_config_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "card_image_id": "7d943c51-e4ff-4e57-9558-08cab6b963c7",
        "shipping": {},
        "card_status": "ACTIVE",
        "memo": "<string>",
        "pending_reasons": {},
        "status_reason": "ACT",
        "card_fulfillment_status": "DIGITALLY_PRESENTED",
        "fulfillment_details": {},
        "bin": "<string>",
        "card_brand": "MASTERCARD",
        "physical_card_format": "CHIP"
      },
      "tenant": "abcdef_ghijkl",
      "type": "CREDIT"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
last_four
string

The last 4 digits of the card PAN

Example:

"1234"

​
bulk_order_id
string<uuid>

The unique identifier of a bulk order in which the card was fulfilled

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
customer_id
string<uuid>

The unique identifier of a customer

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
card_brand
enum<string>

The brand of a card product

Available options:
MASTERCARD,
VISA
​
bin_prefix
string

The BIN number that prefixes a card PAN (first 6 or 8 digits)

Example:

123456

​
emboss_name
string

emboss name

​
bulk_order_config_id
string<uuid>

The unique identifier of a bulk order configuration

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
form
enum<string>

The format of the card

Available options:
PHYSICAL,
VIRTUAL
​
expires_before
string<date>

The date representing when the card will expire or become invalid before.

Example:

"2006-01-02"

​
page_token
string

Optional pagination token to be provided to retrieve subsequent pages, returned from previous get

Example:

"a8937a0d"

​
card_status
enum<string>

The status of a card

Available options:
ACTIVE,
PENDING,
REJECTED,
SUSPENDED,
TERMINATED,
UNACTIVATED
​
card_product_id
string<uuid>

The unique identifier of a cards product

Example:

"7d943c51-e4ff-4e57-9558-08cab6b963c7"

​
account_id
string<uuid>[]

Account ID(s). Multiple IDs can be provided as a comma-separated list.

The unique identifier of an account

​
limit
integer
default:100

Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

Required range: x >= 1
Example:

100

​
barcode
string

The barcode associated with a card

Example:

10044461864615598000

​
expiration_date
string<date>

The date representing when the card would expire at

Example:

"2006-01-02"

​
sort_by
enum<string>[]

Specifies the sort order for the returned cards.

Response

Cards

​
cards
(Credit Card · object | Debit Card · object)[]
required

Array of Cards

​
next_page_token
string

If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

Example:

"a8937a0d"