List Cards

GET 
https://api.immersve.com/api/accounts/:accountId/cards

Lists cards by account.

This API uses cursor-based pagination. Start by making a request without a cursor to get the first page. Use the nextCursor from the pageInfo in the response as the cursor for subsequent requests to retrieve further pages. Continue until nextCursor is undefined, indicating no more data.

Request

Path Parameters

accountId stringrequired

AccountId linked to transactions

Query Parameters

limit number

Number of records to return

cursor string

Cursor to retrieve the next page of records

excludeExpired boolean

Filter by expiry state

status string

Possible values: [created, active, cancelled, shipped]

Filter by card status

expiresAfter string

Timestamp to filter out cards with an expiration date after the given time. Value should be an ISO 8601 string or RFC 2822 string. excludeExpired must be false

Responses

200

Successful operation

application/json

Schema

Schema

items

object[]

Array [

id stringrequired

Card primary identifier

accountId stringrequired

User account ID linked to card

type stringrequired

Possible values: [virtual]

Type of the card

createdAt stringrequired

Timestamp of card creation

modifiedAt stringrequired

Timestamp of card modification

expiresAt stringrequired

Timestamp of card expiration

isBlocked booleanrequired

Whether the card is blocked

status stringrequired

Possible values: [active, cancelled, created, shipped]

Status of the card

fundingSourceIds arrayrequired

List of Funding Source IDs linked to the card

cardProgramId stringrequired

ID of card program linked to the card

regionCode stringrequired

An Alpha2 (ISO-3166-1) country code representing the country where the card is issued.

expiry string

Expiry date of the card in the format YYYYMM

panFirst6 string

First 6 digits of the card's PAN (Primary Account Number)

panLast4 string

Last 4 digits of the card's PAN (Primary Account Number)

immersveExpiration string

Deprecated field, use expiresAt

]

pageInfo

object

Page info for paginated results, undefined if no page info

nextCursor string

Cursor for next page, undefined if no more pages

Example (from schema)

{
  "items": [
    {
      "id": "91ad6fea3b52ca58d60d7fd310f789ec",
      "accountId": "057aa15913a57f50577234c8426534c0",
      "type": "virtual",
      "createdAt": "2022-11-16T03:13:18.142Z",
      "modifiedAt": "2022-11-16T03:13:18.142Z",
      "expiresAt": "2029-02-28T23:59:59.999Z",
      "isBlocked": true,
      "status": "active",
      "fundingSourceIds": [
        null
      ],
      "cardProgramId": "91ad6fea3b52ca58d60d7fd310f789ec",
      "regionCode": "NZ",
      "expiry": "202409",
      "panFirst6": "123456",
      "panLast4": "1920",
      "immersveExpiration": "2022-11-16T03:18:23.431Z"
    }
  ],
  "pageInfo": {
    "nextCursor": "dGhlIG5leHQgY3Vyc29yIGdvZXMgaGVyZQ=="
  }
}

400

Request fields are invalid

application/json

Schema

Schema

statusCode integerrequired
statusName stringrequired
errorCode stringrequired

errors

object[]

Array [

message string

path string

The location of the invalid path param, query param or payload attribute.

]

Example (from schema)

{
  "statusCode": 400,
  "statusName": "Bad Request",
  "errorCode": "INVALID_REQUEST_INPUT",
  "errors": [
    {
      "message": "Invalid type",
      "path": "items[1].attributes.invalidField"
    }
  ]
}

403

No Authorization to access resource.

application/json

Schema

Schema

statusCode integerrequired
statusName stringrequired
errorCode stringrequired
reason string

Example (from schema)

{
  "statusCode": 403,
  "statusName": "Forbidden",
  "errorCode": "FORBIDDEN",
  "reason": "Unauthorized"
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://api.immersve.com/api/accounts/:accountId/cards' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Base URL

https://api.immersve.com

Auth

Security Scheme

Access TokenAccess Token and Target AccountApi Key and Api SecretApi Key and Api Secret and Target Account

Bearer Token

Parameters

accountId — pathrequired

limit — query

cursor — query

excludeExpired — query

---truefalse

status — query

---createdactivecancelledshipped

expiresAfter — query

ResponseClear

Click the Send API Request button above and see the response here!