# Index card transactions

Returns all card transactions associated with the card ID specified in the request URL. Use the filter parameters to narrow down the results according to your needs.

Endpoint: GET /v1/cards/{card_id}/transactions
Version: 1.0

## Path parameters:

  - `card_id` (string, required)
    ID of the card.

## Query parameters:

  - `filter[card_transaction_id]` (string)
    Filter the results by card transaction ID. (One value)

  - `filter[created_at][min]` (string)
    Filter the results by the date/time when the transaction was created (from a given date/time value in UTC format).

  - `filter[created_at][max]` (string)
    Filter the results by the date/time when the transaction was created (until a given date/time value in UTC format).

  - `filter[partner_id]` (string)
    Filter the results by partner ID.

  - `filter[iban]` (string)
    Filter the results by associated IBAN.

  - `filter[transaction_key]` (string)
    Filter the results by the transaction key.

  - `filter[hashed_transaction_key]` (string)
    Filter the results by the hashed transaction key.

  - `filter[indicators]` (string)
    Filter the results by transaction indicator.
    Enum: "PREMATURELY_RESOLVED_RESERVATIONS_MATCHED", "RESERVED_LESS_THAN_SETTLED", "SETTLED_BUT_NOT_RESERVED_BEFORE"

  - `filter[status]` (string)
    Filter the results by transaction status.
    Enum: "ACTIVE", "EXPIRED", "INITIATED", "PROCESSED", "RESOLVED", "REVERSED", "SETTLED"

  - `filter[approval_code]` (string)
    Filter the results by approval code.

  - `filter[merchant_name]` (string)
    Filter the results by merchant name.

  - `filter[merchant_id]` (string)
    Filter the results by merchant ID.

  - `filter[core_banking_reservation_id]` (string)
    Filter the results by core banking reservation ID.

  - `filter[core_banking_transaction_id]` (string)
    Filter the results by core banking transaction ID.

  - `filter[amount]` (integer)
    Filter the results by the amount deducted from the customer's account.

  - `filter[transaction_amount]` (integer)
    Filter the results by the transaction amount.

  - `filter[declined]` (boolean)
    Return only declined transactions.

  - `page[number]` (integer)
    Specifies the number of results pages to return.

  - `page[size]` (integer)
    Specifies the number of entries on each results page.

## Response 200 fields (application/json):

  - `id` (string)
    ID of the transaction.

  - `created_at` (string)
    UTC timestamp from when the transaction was created.
    Example: "2024-07-30T13:56:54+0000"

  - `indicators` (string,null)
    Indicator related to the transaction.
    Enum: "PREMATURELY_RESOLVED_RESERVATIONS_MATCHED", "RESERVED_LESS_THAN_SETTLED", "SETTLED_BUT_NOT_RESERVED_BEFORE"

  - `transaction_events` (array)
    Array of events related to the transaction.

  - `transaction_events.source` (string)
    Enum: "AUTHORIZATION", "AUTHORIZATION_DECLINE", "CREDIT_TRANSACTION", "SETTLEMENT"

  - `transaction_events.acquirer_id` (string)
    Example: "12345678901"

  - `transaction_events.amount` (string)
    Example: "-20000"

  - `transaction_events.approval_code` (string)
    Example: "667163"

  - `transaction_events.card_identifier` (string)
    Example: "503000477045"

  - `transaction_events.card_transaction_id` (string)
    Example: "6e3cec44-755c-4e79-a3d7-b90890188289"

  - `transaction_events.card_id` (string)
    Example: "4474c121fa1444286e42406543ca162bmcrd"

  - `transaction_events.core_banking_reservation_id` (string)
    Example: "345dff59-229f-5972-bb8d-534feee37c2b"

  - `transaction_events.core_banking_transaction_id` (string)
    Example: "fbcd8795-f129-5cb5-9759-222a7d56639a"

  - `transaction_events.created_at` (string)

  - `transaction_events.iban` (string)
    Example: "DE112222222223333333333"

  - `transaction_events.indicators` (string)

  - `transaction_events.merchant_category_code` (string)
    Example: "0121"

  - `transaction_events.merchant_id` (string)
    Example: "009399565"

  - `transaction_events.merchant_name` (string)
    Example: "foo"

  - `transaction_events.merchant_town` (string)
    Example: "bar"

  - `transaction_events.origin_created_at` (string)

  - `transaction_events.origin_updated_at` (string)

  - `transaction_events.partner_id` (string)
    Example: "d0abb30f450a42d54bfef78d1e021e6bcpar"

  - `transaction_events.pos_entry_mode` (string)
    Example: "UNKNOWN"

  - `transaction_events.status` (string)
    Example: "SETTLED"

  - `transaction_events.terminal_id` (string)
    Example: "1.1"

  - `transaction_events.transaction_amount` (string)
    Example: "20000"

  - `transaction_events.transaction_key` (string)
    Example: "100000000667163"

  - `transaction_events.transaction_type` (string)
    Example: "PURCHASE"

  - `transaction_events.interchange_fee_amount` (string)
    Example: "20000"

  - `transaction_events.id` (string)
    Example: "4bf431a0-9718-4cb5-85ce-c0515e472968"

  - `transaction_events.updated_at` (string)

  - `transaction_events.transaction_currency_code` (string)

  - `transaction_events.fx_rate` (string)
    Example: "2.0"

  - `transaction_events.merchant_country_code` (string)
    Example: "merchant_country_code"

  - `transaction_events.acquirer_reference_number` (string)

  - `transaction_events.transaction_country_code` (string)
    Example: "transaction_country_code"

  - `transaction_events.card_holder_authentication_verification_value` (string)

  - `transaction_events.token_provider` (string)
    Example: "APPLE"

  - `transaction_events.token_type` (string)
    Example: "02"

  - `transaction_events.token_number` (string)
    Example: "4113112380202020"

  - `transaction_events.decline_reasons` (array)

  - `transaction_events.decline_reasons.type` (string)

  - `transaction_events.decline_reasons.message` (string)

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Solaris::Identification' for id 'bbbcccfff388923eb899a5852df6cidt'."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."