Skip to main content
POST
Classify transactions
The request returns a job ID. Check the results with Get classification status. Items that need review stay unposted. Posting needs valid account mappings and an open accounting period. Check the classification and posting result of each item before you retry.

Authorizations

X-API-Key
string
header
required

Your organization API key. Some operations also need a key that is associated with a user; their pages say so.

Headers

Idempotency-Key
string
required

Unique key for this operation. Retry with the same key and request body after a timeout. Keys are retained for at least 24 hours.

Required string length: 1 - 255

Body

application/json
sequence_numbers
string[]

OT-#### transaction sequence numbers—the easiest way to target exact transactions.

Maximum array length: 100
Pattern: ^OT-[0-9]+$
transaction_ids
string[]

Transaction IDs (txn_…).

Maximum array length: 100
Pattern: ^txn_
date_from
string<date>

Inclusive ISO date. Must be paired with date_to; the range may not exceed 92 days.

date_to
string<date>

Inclusive ISO date. Must be paired with date_from; the range may not exceed 92 days.

source_ids
string[]

Source IDs (fac_…). Use source_types to filter by platform.

Maximum array length: 100
Pattern: ^fac_
source_types
enum<string>[]

Source types, such as WALLET, BANK_SOURCE, RAMP_CARD, RAINCARD, or EXCHANGE_SOURCE.

Maximum array length: 30
Available options:
WALLET,
EXCHANGE_SOURCE,
RAINCARD,
STAKING_SOURCE,
RAIN_BILL_PAY,
NIURAL_SOURCE,
FIREBLOCKS,
BANK_SOURCE,
RAMP_CARD,
RAMP_BANK_ACCOUNT,
RAMP_STATEMENT,
RAMP_REIMBURSEMENT,
MANUAL_BANK_STATEMENT,
MANUAL_EXCHANGE_STATEMENT,
FINCH_PAYROLL,
STRIPE

Legal entities (le_…).

Maximum array length: 100
Pattern: ^le_
classifications
enum<string>[]

Transaction types. Transfer values use spaces: INTERNAL TRANSFER and INTERCOMPANY TRANSFER.

Maximum array length: 30
Available options:
SWAP,
NON_TAXABLE_CONVERSION,
DEPOSIT,
WITHDRAWAL,
BRIDGE,
INTERCOMPANY TRANSFER,
INTERNAL TRANSFER,
FEE,
MINTING,
SPAM,
NFT,
UNKNOWN,
STAKING_REWARD,
VALIDATOR_REWARD,
INVOICE,
BILL,
CLAIM REWARD,
BORROW,
RESERVES CHANGE,
REPAYMENT,
REALIZED_PNL,
INCOME,
EXPENSE,
REFUND,
CHARGEBACK
search_term
string

Case-insensitive text search. Must be accompanied by unaccounted_only: false.

Required string length: 1 - 256
unaccounted_only
boolean

Only transactions without journal entries. Defaults to true outside search mode.

confidence_threshold
number

Minimum confidence for automatic classification. Defaults to 0.85.

Required range: 0 <= x <= 1

Response

Accepted. Check the progress and results with Get classification status, at the Location URL.

data
object
required