List card transactions - QASH API Reference

Authorizations

X-Api-Key

string

header

required

Partner API key. Generated from Qash Dashboard → Settings → API Keys.

Query Parameters

cardId

string<uuid>

Filter by a specific card identifier.

type

string

Filter by transaction type.

limit

integer

default:50

Maximum number of results to return. Defaults to 50.

Required range: x >= 1

cursor

string

Pagination cursor from a previous response.

Response

Transaction history returned successfully.

items

object[]

required

Hide child attributes

items.id

string

required

Unique transaction identifier.

Example:

"txn_a1b2c3d4e5f6"

items.type

string

required

Transaction type. Currently spend is the primary type.

Example:

"spend"

items.spend

object

required

Hide child attributes

items.spend.amount

number

required

Transaction amount in the billing currency.

Example:

45

items.spend.currency

string

required

Billing currency code (ISO 4217).

Example:

"USD"

items.spend.receipt

boolean

required

Whether a receipt has been attached to this transaction.

Example:

false

items.spend.merchantName

string

required

Raw merchant name as reported by the card network.

Example:

"Amazon"

items.spend.merchantCategory

string

required

Merchant category label derived from the MCC.

Example:

"Online Retail"

items.spend.merchantCategoryCode

string

required

ISO 18245 Merchant Category Code (MCC).

Example:

"5999"

items.spend.cardId

string<uuid>

required

UUID of the card used for this transaction.

Example:

"card-uuid-1234"

items.spend.cardType

string

required

Type of card (virtual or physical).

Example:

"virtual"

items.spend.companyId

string<uuid>

required

UUID of the company associated with the card.

Example:

"company-uuid-5678"

items.spend.userId

string<uuid>

required

UUID of the user who made the transaction.

Example:

"user-uuid-9012"

items.spend.userFirstName

string

required

First name of the cardholder.

Example:

"John"

items.spend.userEmail

string<email>

required

Email address of the cardholder.

Example:

"john@company.com"

items.spend.status

enum<string>

required

Transaction status.

Available options:

pending,

completed,

declined,

reversed

Example:

"completed"

items.spend.authorizedAt

string<date-time>

required

Timestamp when the transaction was authorized (ISO 8601).

Example:

"2024-01-15T10:30:00Z"

items.spend.localAmount

number | null

Amount in the local currency at the point of sale. Null when not available.

Example:

45

items.spend.localCurrency

string | null

Local currency code at the point of sale (ISO 4217). Null when not available.

Example:

"USD"

items.spend.authorizedAmount

number | null

Amount that was authorized. May differ from the final settled amount. Null when not available.

Example:

45

items.spend.authorizationMethod

string | null

Method used to authorize the transaction (e.g. chip, contactless, online). Null when not available.

Example:

"chip"

items.spend.memo

string | null

Free-text memo attached to the transaction. Null when absent.

Example:

null

items.spend.merchantId

string | null

Internal merchant identifier. Null when not available.

Example:

"merchant_xyz"

items.spend.enrichedMerchantIcon

string<uri> | null

URL to the enriched merchant logo. Null when not available.

Example:

"https://logo.clearbit.com/amazon.com"

items.spend.enrichedMerchantName

string | null

Cleaned-up merchant name from enrichment. Null when not available.

Example:

"Amazon"

items.spend.enrichedMerchantCategory

string | null

Enriched merchant category label. Null when not available.

Example:

"Shopping"

items.spend.userLastName

string | null

Last name of the cardholder. Null when not available.

Example:

"Doe"

items.spend.declinedReason

string | null

Reason the transaction was declined. Present only when status is declined, null otherwise.

Example:

null

items.spend.postedAt

string<date-time> | null

Timestamp when the transaction was posted/settled (ISO 8601). Null while still pending.

Example:

"2024-01-16T08:00:00Z"

nextCursor

string | null

Opaque cursor for retrieving the next page of results. Null when there are no more pages.

Example:

"eyJpZCI6InR4bl9hMWIyYzNkNGU1ZjYifQ=="