Availability and SLA
- Coverage: Each report covers the prior calendar day from 00:00 through 24:00 UTC.
- When it is ready: The report is committed to be available by 06:00 UTC the next day. Typically, it is ready around 02:00 UTC.
- One file, multiple currencies: USDC and EURC statements are delivered in a
single XML file as separate
Stmtblocks.
Retrieve the report
Retrieve the CAMT.053 report by first calling Request a report withreportType: camt053 and date in YYYY-MM-DD format (the UTC calendar date
the statement covers), then use the returned id with one of the following
endpoints:
- Get report by ID:
Returns JSON with a
dataobject that includesdownloadUrlandexpiresAt. Download the XML fromdownloadUrlbefore the time indicated byexpiresAt. - Get report content:
Returns the raw XML as
application/xml. The response uses aContent-Dispositionattachment filename such ascamt053_YYYY-MM-DD_report.xml.
Read and reconcile the report
The report follows the ISO 20022 CAMT.053.001.13 structure. The sections below cover the key elements you need for reconciliation.File format at a glance
The report uses ISO 20022 CAMT.053.001.13 XML structure. See the ISO 20022 message definitions catalog for official message definitions.- The file uses namespace
urn:iso:std:iso:20022:tech:xsd:camt.053.001.13. - The root is
Document→BkToCstmrStmt→ one or moreStmtelements. - Each
Stmtis one account and currency. - Inside a statement you will see opening and closing balances and
Ntry(entry) elements. There is oneNtryper movement that affects the balance.
Balances
EachStmt includes opening and closing balances for the report date:
OPBD: Opening booked balance for the report date.CLBD: Closing booked balance for the report date.
Ccy (currency), CdtDbtInd (credit or debit
side of the balance), and a timestamp. For reconciliation, a common check is:
opening balance plus the sum of entries (respecting credit and debit) aligns
with closing balance for that statement.
Currency vs token
Standard ISO 20022 fields follow ISO 4217. They use three-letter currency codes onAmt and related standard elements:
USDfor USDC transactions (for example<Amt Ccy="USD">).EURfor EURC transactions (for example<Amt Ccy="EUR">).
USDC or EURC) is preserved on each transaction
line. At the transaction level it follows the path Ntry → NtryDtls →
TxDtls → SplmtryData → CircleTxn
→ Token.
Use both when you need to match fiat-style accounting codes and token
identifiers.
Transaction entries (<Ntry>)
Each Ntry is one transaction line. Important children include:
Amt: Amount and ISO currency on the amount (USDorEUR).CdtDbtInd:CRDT(credit) orDBIT(debit).Sts: Booking status inCd, such as:BOOK: BookedPDNG: PendingRJCT: RejectedFAIL: Failed
BookgDt: Booking time inDtTm, UTC (ISO 8601).BkTxCd: Circle’s label for the transaction type, found underPrtry/Cd. New labels can appear over time. Unmapped types may show asUNKNOWN.
Circle transaction details (CircleTxn)
Circle adds detail under Ntry → NtryDtls → TxDtls → SplmtryData where
PlcAndNm is CircleTransactionData. Inside the envelope, CircleTxn uses
namespace urn:circle:camt053:transaction.
The following child elements may appear on a transaction line. This list is not
exhaustive — your parser should tolerate additional elements and fields that are
omitted.
TransactionId: Identifier for the movement.JobId: Related job identifier.Token: Full token identifier (USDCorEURC).CustomReferenceId: Customer-provided reference when supplied.ExternalReferenceId: EFT-style reference when supplied (for exampleIMADorUETR).Blockchain: Blockchain identifier when the movement is onchain.TransactionHash: Onchain transaction hash when present.Source: Originating party or address when populated.SourceType: Type of source (for example fiat account or blockchain address) when populated.Destination: Receiving party or address when populated.DestinationType: Type of destination when populated.CustomerId: Customer association when present.
Example truncated statement
The example below shows the header, one statement with opening and closing balances, and one entry (abbreviated). It is only for orientation. Your real files can contain many entries and a second statement for the other currency.Example CAMT.053 fragment