Get all cards - Kobble

Request

Query Params

from

string <date-time>

optional

Example:

to

string <date-time>

optional

Example:

offset

number

optional

Example:

0

limit

number

optional

Example:

10

order

enum<string>

optional

Allowed values:

ascdesc

Example:

asc

Header Params

Authorization

string

required

Example:

Bearer {{access_token}}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request GET '/customers/v1/cards?from={{$date.isoTimestamp}}&to={{$date.isoTimestamp}}&offset=0&limit=10&order=asc' \
--header 'Authorization: Bearer {{access_token}}'

Responses

🟢200OK

application/json

Headers

X-Total-Count

integer

optional

The total number of cards

Example:

10

X-Offset

integer

optional

The offset applied for pagination

Example:

10

X-Limit

integer

optional

The limit applied for pagination

Example:

10

Body

array of:

id

string <uuid>

required

The unique identifier of the card.

type

enum<string>

required

The type of card (virtual or physical).

Allowed values:

VIRTUALPHYSICAL

wallet_id

string <uuid>

required

The wallet ID associated with the card.

created_at

string <date-time>

required

The date and time the card was created.

updated_at

string <date-time>

required

The date and time the card was last updated.

status

enum<string>

required

The current status of the card.

Allowed values:

ACTIVEINACTIVESUSPENDEDSTOLENPENDING

external_id

string

required

An external identifier associated with the card.

Example:

1111111

last_four_digit

string

required

The last four digits of the card number.

Example:

1111

expiry

string <date-time>

required

The expiration date of the card.

program_id

string <uuid>

required

The associated card program ID.

m_pan

string

required

The masked primary account number (PAN) of the card.

Example:

1111***1111

Example

[
    {
        "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
        "type": "PHYSICAL",
        "wallet_id": "196ace48-b4ab-1c3f-09be-9ddaa78ed756",
        "created_at": "2025-01-14T02:42:48.682Z",
        "updated_at": "2025-01-14T02:42:48.682Z",
        "status": "INACTIVE",
        "external_id": "1111111",
        "last_four_digit": "1111",
        "expiry": "1984-03-08T01:45:06.208Z",
        "program_id": "7d9a22e0-f9f5-6e49-57e3-5af54b43e0bb",
        "m_pan": "1111***1111"
    },
    {
        "id": "1b8ecc17-4edd-4b74-ae4f-208aeb78f105",
        "type": "VIRTUAL",
        "wallet_id": "eb6f8529-d4ff-28d1-5af1-53eb28220eb4",
        "created_at": "2025-01-14T03:45:07.808Z",
        "updated_at": "2025-01-14T02:42:48.682Z",
        "status": "SUSPENDED",
        "external_id": "1111111",
        "last_four_digit": "1111",
        "expiry": "1996-01-06T22:14:55.364Z",
        "program_id": "4a507f7a-109f-cb73-fba9-6d1db75a00da",
        "m_pan": "1111***1111"
    }
]