Sign in
Cards

List Card Transactions

Lists an account's card transactions, newest first. Defaults to the account the credential belongs to. Covers every card the owner has ever had, including canceled cards and spend that predates a re-application, and team members only see transactions on the cards assigned to them. Pass transaction_ids to fetch specific transactions instead of paging for them.

get/card_transactions

Query parameters

account_idstring

The account whose card transactions to list, prefixed biz_. Defaults to the credential's account.

transaction_idsstring[]

Return only these card transactions, each prefixed citx_. Repeat the parameter, or pass one comma-separated value.

[
  "citx_xxxxxxxxxxxxxx"
]
card_idstring[]

Return only transactions charged to these cards, each prefixed icrd_.

[
  "icrd_xxxxxxxxxxxxxx"
]
cardholder_idstring[]

Return only transactions on cards assigned to these users, each prefixed user_.

[
  "user_xxxxxxxxxxxxxx"
]
status'pending' | 'completed' | 'reversed' | 'declined'

Return only transactions with this status.

created_afterstring

Return only transactions authorized at or after this ISO 8601 timestamp.

created_beforestring

Return only transactions authorized at or before this ISO 8601 timestamp.

order'created_at'

The field to sort by. Defaults to created_at.

direction'asc' | 'desc'

The sort direction. Defaults to desc.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

Response

no owner passed falls back to the credential's account

Example response

{
  "data": [
    {
      "card_id": "icrd_xxxxxxxxxxxxxx",
      "cardholder_id": "user_xxxxxxxxxxxxxx",
      "cashback_usd_amount": 0.25,
      "created_at": "2026-01-01T12:00:00.000Z",
      "currency": "EUR",
      "declined_reason": "account_credit_limit_exceeded",
      "id": "citx_xxxxxxxxxxxxxx",
      "international": true,
      "local_amount": 22.5,
      "merchant_category": "Car Care Supplies",
      "merchant_category_code": "5533",
      "merchant_icon_url": "https://shinetime.example/icons/lone-star-detail-supply.png",
      "merchant_name": "Lone Star Detail Supply",
      "posted_at": "2026-01-01T12:00:00.000Z",
      "status": "completed",
      "transaction_type": "spend",
      "usd_amount": 24.99
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 3 of the 74 revisions of this API.81026

  • ff3a7657356312See the full diff
    • ▲

      for the query request parameter first, default value 20 was added

      request-parameter-default-value-added

    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

  • f1020c3ecda43See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 099fdc3be4227823See the full diff
    • ▲

      the query request parameter direction was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter status was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      for the query request parameter card_id, the type changed from string null to array

      request-parameter-type-changed

    • ▲

      the // response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      the // response's property format changed from date-time to no format for status

      response-property-type-changed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ●

      deleted the query request parameter company_id

      request-parameter-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      removed the optional property / from the response with the status

      response-optional-property-removed

    • ●

      added the new spend enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      api operation id listCardTransaction removed and replaced with listCardTransactions

      api-operation-id-removed

    • ○

      api tag Cards added

      api-tag-added

    • ○

      api tag Card transactions removed

      api-tag-removed

    • ○

      added the new optional header request parameter Api-Version-Date to all path's operations

      new-optional-request-default-parameter-to-existing-path

    • ○

      added the new optional query request parameter account_id

      new-optional-request-parameter

    • ○

      added the new optional query request parameter cardholder_id

      new-optional-request-parameter

    • ○

      added the new optional query request parameter order

      new-optional-request-parameter

    • ○

      added the new optional query request parameter transaction_ids

      new-optional-request-parameter

    • ○

      added the new enum value asc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value completed to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value declined to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value desc to the query request parameter direction

      request-parameter-enum-value-added

    • ○

      added the new enum value pending to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value reversed to the query request parameter status

      request-parameter-enum-value-added

    • ○

      for the query request parameter created_after, the type was generalized from string null to string, and format from date-time to no format

      request-parameter-type-generalized

    • ○

      for the query request parameter created_before, the type was generalized from string null to string, and format from date-time to no format

      request-parameter-type-generalized

    • ○

      for the query request parameter direction, the type was generalized from no type to string

      request-parameter-type-generalized

    • ○

      for the query request parameter status, the type was generalized from no type to string

      request-parameter-type-generalized

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      removed the non-success response with the status

      response-non-success-status-removed

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.