SequenceSequence
Cards
Coming Soon — This endpoint is planned for a future release and is not yet available.
GET/cards

Returns debit cards for the organization. account_id is required and must be present in the token's READ_CARDS resources.

AuthorizationClick to expand
ApiKeyAuth
Authorization<token>

Format: ApiKey <key>. Keys are scoped to an organization and carry explicit permissions.

Each key holds a list of permission entries. An entry specifies a scope and a resources constraint. A request returns 403 if the key lacks the required scope, or if the requested resource is outside the key's allowed list.

ScopeResourcesGrants access to
LIST_ACCOUNTSnoneList all accounts in the organization
READ_ACCOUNTSaccount IDs or *Full account details and balance for a specific account
LIST_RULESnoneList all rules in the organization
READ_RULESrule IDs or *Full rule details (steps, conditions, actions) for a specific rule
TRIGGER_RULESrule IDs or *Triggering rule executions
READ_RULE_EXECUTIONSrule IDs or *Rule execution history - rule_id filter required
READ_TRANSFERSaccount IDs or *Transfer history - account_id filter required
MANUAL_TRANSFERlist of { source, target, max_amount? } setsCreating manual transfers
READ_CARDSaccount IDs or *Cards and card transactions - account_id filter required

In: header

Query Parameters

account_id*string

Pod ID to filter by. Must be present in the token's `READ_CARDS` resources.

status?string, Value in "active" | "inactive" | "frozen" | "stolen" | "lost"

Filter by card status.

type?string, Value in "virtual" | "physical"

Filter by card type.

Header Parameters

X-Request-ID?string

A client-provided request identifier echoed back in the response `X-Request-ID` header and `request_id` body field. If omitted, the server generates one.

Response Body

application/json

application/json

application/json

curl -X GET "https://api.getsequence.io/api/v1/cards?account_id=string"
{
  "request_id": "req_01HABC9000",
  "data": [
    {
      "id": "card_01HABC4567",
      "type": "physical",
      "status": "active",
      "last_four": "4242",
      "holder_name": "John Smith",
      "expiration_date": "09/28",
      "account_id": "acc_01HDEF0123",
      "created_at": "2024-01-15T10:00:00Z"
    },
    {
      "id": "card_01HDEF0123",
      "type": "virtual",
      "status": "active",
      "last_four": "1234",
      "holder_name": "John Smith",
      "expiration_date": "09/28",
      "account_id": "acc_01HDEF0123",
      "created_at": "2024-02-01T09:00:00Z"
    }
  ]
}
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "This API key does not have the required permission."
  }
}

List card transactions GETv2

Returns transactions for a specific card, ordered by `created_at` descending. Includes purchases (debits) and refunds (credits). The card's linked account ID must be present in the token's `READ_CARDS` resources.

Get a card GETv2

Returns a single card by ID. The card's linked account ID must be present in the token's `READ_CARDS` resources.