Get card transactions

Endpoint

POST /{san}/transactions

Path parameters

  • san — Unique card identifier in the CinCin system

Request

circle-info

Content-Type: application/json

Request body

Request (application/json)
{
  "page": 0,
  "size": 20,
  "from": "2026-01-01T00:00:00.000Z",
  "to": "2026-02-04T23:59:59.999Z"
}

Request parameters

  • *page (number) — Page number (0-based)

  • *size (number) — Number of transactions per page

  • from (string ISO 8601) — Start date for filtering

  • to (string ISO 8601) — End date for filtering

Response

Response parameters

  • total (number) — Total number of transactions matching the query

  • list (array) — Array of transaction objects

  • list[].date (string ISO 8601) — Transaction date and time in UTC

  • list[].authorizationCode (string, null) — Authorization code for the transaction (if available)

  • list[].transactionId (string) — Unique transaction identifier

  • list[].isForcePost (boolean) — Indicates if the transaction was force-posted

  • list[].transactionSum (decimal) — Total transaction amount including commission

  • list[].transactionCommission (decimal) — Commission fee charged for the transaction

  • list[].cardCurrency (string) — Currency code

  • list[].transactionRecipient (string) — Merchant name and location information

  • list[].merchantCategory (string, null) — Merchant Category Code (MCC) if available

  • list[].id (string UUID) — Internal transaction record identifier

  • list[].transactionValue (decimal) — Transaction amount before commission

  • list[].declineReason — Reason for decline if transaction was declined

  • list[].status (string) — Transaction status

Transaction status enum list

  • pending — Transaction authorization pending

  • expense — Completed expense/purchase transaction

  • cancellation — Transaction declined or cancelled

  • hold — Amount held pending completion

  • hold (refund) — Amount held for refund processing

  • refund — Refund transaction completed

  • reversal — Transaction reversed

  • atm — ATM cash withdrawal

Last updated