List card transactions

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Query Parameters

cursor

string

The opaque metadata.nextCursor value from the previous page. It carries that page's filters, page size and ordering, so pass it on its own; see Pagination.

limit

integer

Number of items per page, from 1 to 100. The page size is carried inside metadata.nextCursor, so later pages keep the same size unless limit is passed again to change it.

Required range: 1 <= x <= 100

sort

enum<string>

default:date

Field to order the page by. Each value has its own default direction, used unless sortDirection is passed. See Sorting.

date (default) — the transaction's date (the posting date, or the creation date while pending or failed); descending
authorizedAt — the card authorization time; descending

Available options:

date,

authorizedAt

sortDirection

enum<string>

Direction of the ordering selected by sort. When omitted, each sort value uses its own default; see Sorting.

Available options:

asc,

desc

accountId

string

Return activity for one accessible Account.

virtualAccountId

string

Return card transactions associated with one accessible virtual account. Transactions without a virtual-account association do not match.

status

enum<string>

Return card transactions with this broad accounting status. Coarse transaction state.

Available options:

pending,

posted,

failed

detailedStatus

enum<string>

Return card transactions in this exact lifecycle state. Exact lifecycle state of a card transaction.

Available options:

pending,

canceled,

failed,

settled,

declined,

refund,

reversed,

dispute

from

string<date-time>

Inclusive RFC 3339 lower bound on transaction date.

string<date-time>

Inclusive RFC 3339 upper bound on transaction date.

cardId

string

Return transactions for one card.

cardGroupId

string

Return transactions for cards in one card group.

providerAuthorizationId

string

Return the transaction with this processor authorization id.

authorizedFrom

string<date-time>

Inclusive RFC 3339 lower bound on authorization time.

authorizedTo

string<date-time>

Inclusive RFC 3339 upper bound on authorization time.

includeSummary

boolean

default:false

Include totals across the complete filtered result, not only this page.

Response

A page of card transactions.

items

TransactionCard · object[]

required

Hide child attributes

items.id

string

required

Transaction id.

Example:

"agg_tx_2rj4l7hmrrrcv"

items.date

string<date-time>

required

Posting date, or creation date while pending or failed.

Example:

"2026-08-18T01:00:00.000Z"

items.description

string

required

Statement descriptor when one was supplied; otherwise a Slash-generated display description.

Example:

"VENDOR PAYMENT"

items.amountCents

integer

required

Signed USD account impact in cents. Debits are negative.

Example:

-1250

items.status

enum<string>

required

Coarse transaction state.

Available options:

pending,

posted,

failed

items.accountId

string

required

Account containing the transaction.

Example:

"sa_group_primary123"

items.accountSubtype

enum<string>

required

Balance type affected by the transaction.

Available options:

cash,

credit

Example:

"cash"

items.category

enum<string>

required

Available options:

card

items.detailedStatus

enum<string>

required

Exact lifecycle state of a card transaction.

Available options:

pending,

canceled,

failed,

settled,

declined,

refund,

reversed,

dispute

items.memo

string

Human-readable payment memo, when present. For transfers, this is the request's top-level description.

Example:

"Invoice 1042"

items.note

string

User-editable private note, when present.

Example:

"Reconciled with invoice 1042"

items.virtualAccountId

string

Virtual account containing the transaction, when applicable.

Example:

"subaccount_operations123"

items.transferId

string

The transfer that produced this transaction, if any. Uses the transfer_intent_ prefix.

Example:

"transfer_intent_2rj4l7hmrrrcv"

items.accountingEntryId

string

The accounting entry created for this transaction once it settled, if the legal entity has an accounting connection. Read it at GET /v2/accounting/entries/{entryId}.

Example:

"accounting_entry_2rj4l7hmrrrcv"

items.originalCurrency

object

Original currency details when the transaction was converted. Despite the historical amountCents field name, the amount uses the original currency's native minor unit.

Hide child attributes

items.originalCurrency.code

string

required

items.originalCurrency.amountCents

number

required

Amount in the original currency's native minor unit.

items.originalCurrency.conversionRate

number

items.details

object

Card, merchant, and authorization data for a card transaction.

Hide child attributes

items.details.cardId

string

items.details.merchant

object

Hide child attributes

items.details.merchant.description

string

required

items.details.merchant.categoryCode

string

required

The merchant category code (MCC) the network reported.

items.details.merchant.id

string

The merchant's id, with the merchant_v2_ prefix. Use it as a merchant source in PUT /v2/accounting/mappings to code every transaction at this merchant the same way. Absent while the merchant is still being identified.

Example:

"merchant_v2_2rj4l7hmrrrcv"

items.details.merchant.categoryId

string

The Slash merchant category the categoryCode falls in, with the merchant_category_ prefix. Use it as a merchant_category source in PUT /v2/accounting/mappings to code every transaction in the category the same way. Absent when the code is not in any category.

Example:

"merchant_category_2rj4l7hmrrrcv"

items.details.merchant.location

object

Hide child attributes

items.details.merchant.location.city

string

required

items.details.merchant.location.state

string

required

items.details.merchant.location.country

string

required

items.details.merchant.location.zip

string

required

items.details.orderId

string

items.details.referenceNumber

string

items.details.authorizedAt

string<date-time>

items.details.declineReason

string

items.details.approvalReason

string

items.details.providerAuthorizationId

string

items.details.cashback

object

Hide child attributes

items.details.cashback.amountCents

integer

required

Cashback earned, in cents.

items.details.cashback.rate

number

required

items.details.fxFee

object

Hide child attributes

items.details.fxFee.amountCents

integer

required

Foreign transaction fee charged, in cents.

metadata

PaginationMetadata · object

required

Hide child attributes

metadata.count

integer

required

Number of items in this page.

Required range: x >= 0

metadata.nextCursor

string

Opaque cursor for the next page. Omitted on the final page.

summary

TransactionSummary · object

Totals over every transaction matching the request's filters, not just the returned page. Present only when includeSummary=true.

Hide child attributes

summary.count

integer

required

Number of matching transactions.

summary.totalInCents

integer

required

Sum of positive amounts, in cents. Excludes failed, declined, canceled, and reversed transactions and transfers between virtual accounts.

summary.totalOutCents

integer

required

Sum of negative amounts, in cents, with the same exclusions as totalInCents.

summary.netChangeCents

integer

required

totalInCents + totalOutCents.

Banking

Money movement

Cards

Bill pay

Invoicing

Accounting

Platform

List card transactions

Authorizations

Headers

Query Parameters

Response