Movement Management APIs
1. Retrieve Movement Details
Fetches details of a specific movement, including debit/credit accounts, amount, and status.
Example: A finance manager retrieves a movement record to confirm whether a customer refund was correctly processed.
Retrieves the data for a previously executed instruction.
Response to /api/v1/instruction/{id}
Information about an instruction and the activities it contains.
The time at which a record of the instruction was made by the leddger.
An agent supplied identifier for the instruction that is globally unique.
default response to /api/v1/instruction/{id}
GET /api/v1/instruction/{id}?data=text HTTP/1.1
Accept: */*
{
"@type": "cac_ledger_schema_data_ledger_instruction_data",
"activities": [
{
"info": {
"@type": "cac_ledger_schema_info_ledger_activity_info",
"adjust_value": true,
"amount": 1,
"attrs_changed": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"credit_wallet_address": "text",
"debit_wallet_address": "text",
"decimal_places": 1,
"finalize": true,
"id": "123e4567-e89b-12d3-a456-426614174000",
"tags_added": [
"text"
],
"value_date": "2026-01-01T00:00:00.000Z"
},
"ordinal": 1
}
],
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"created_at": "2026-01-01T00:00:00.000Z",
"id": "123e4567-e89b-12d3-a456-426614174000"
}2. Track Wallet Movement
Tracks fund transfers between wallets to ensure accurate ledger entries.
Example: A retail company verifies movement between customer accounts when processing store credits for product returns.
Retrieves an account wallet.
Response to /api/v1/group/{group}/{account}/{wallet}/{currency}
An addressable collection of funds under an account.
The time at which the wallet was created in the ledger.
The identifier assigned to the wallet by the ledger. A positive number.
The revision number increases with each change to the wallet.
The current status of the wallet.
The time at which the wallet was last updated in the ledger.
default response to /api/v1/group/{group}/{account}/{wallet}/{currency}
GET /api/v1/group/{group}/{account}/{wallet}/{currency} HTTP/1.1
Accept: */*
{
"@type": "cac_ledger_schema_element_ledger_wallet_elem",
"account": {
"@type": "cac_ledger_schema_element_ledger_account_elem",
"chart": {
"@type": "cac_ledger_schema_element_ledger_chart_elem",
"created_at": "2026-01-01T00:00:00.000Z",
"id": 1,
"info": {
"@type": "cac_ledger_schema_info_ledger_chart_info",
"name": "text"
},
"updated_at": "2026-01-01T00:00:00.000Z"
},
"created_at": "2026-01-01T00:00:00.000Z",
"group": {
"@type": "cac_ledger_schema_element_ledger_group_elem",
"created_at": "2026-01-01T00:00:00.000Z",
"id": 1,
"info": {
"@type": "cac_ledger_schema_info_ledger_group_info",
"name": "text"
},
"updated_at": "2026-01-01T00:00:00.000Z"
},
"id": 1,
"info": {
"@type": "cac_ledger_schema_info_ledger_account_info",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"reference": "text",
"tags": [
"text"
]
},
"revision": 1,
"status": "CLOSED",
"updated_at": "2026-01-01T00:00:00.000Z"
},
"created_at": "2026-01-01T00:00:00.000Z",
"id": 1,
"info": {
"@type": "cac_ledger_schema_info_ledger_wallet_info",
"accounting_type": "LIABILITY",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"currency": "text",
"decimal_places": 1,
"name": "text"
},
"revision": 1,
"status": "VALID",
"updated_at": "2026-01-01T00:00:00.000Z"
}Example Use Cases
Transaction Auditing: Retrieve movement details to track fund transfers and verify financial accuracy.
Fraud Detection: Monitor wallet movements to flag suspicious activities, such as large unexpected withdrawals.
Real-Time Fund Tracking: Fetch movement records for live transaction monitoring, ensuring timely processing.
Financial Reconciliation: Compare movement records with postings to verify balance updates and detect discrepancies.
These APIs provide essential tracking capabilities for managing fund transfers, improving transparency, and maintaining ledger accuracy.
Last updated