List intents
GET/intents●Query intents with filtering, sorting, and pagination.
Use this endpoint to track payment status or investigate failed or stuck payments. For historical data exports and reconciliation, use reports instead.
Supported filters:
meta.status— lifecycle statedata.claims.action— claim type (transfer,issue,destroy,limit)data.claims.source.handle— source addressdata.claims.target.handle— target addressdata.claims.symbol.handle— symboldata.claims.amount— claim amount (supports range operators)data.schema— intent schemameta.labels— record labelsmeta.domain— domain scopedata.custom.<field>— any custom field (may be slower on large datasets)
Usage Examples
curl -X GET "http://localhost:3000/v2/intents" \ -H "x-ledger: <YOUR LEDGER HANDLE>"{
"hash": "d7c28f7c0a3c41ee2f43992a83685dab4be389116f2946fe70b5a7e397ac1ec5",
"data": [
{
"luid": "$int.-01xK0rStT2dS4wX3",
"hash": "be40db4425c914903888398a39519b6e9c9b0e047afd40c64f78c95f8f6d64f1",
"data": {
"handle": "transfer-1712345678901",
"claims": [
{
"action": "transfer",
"source": {
"handle": "svgs:1001001212@tesla-bank.com",
"custom": {
"name": "John Doe",
"idType": "nidn",
"idNumber": "123456789",
"entityType": "individual"
}
},
"target": {
"handle": "tran:1001001234@nova-bank.com",
"custom": {
"name": "Jane Smith",
"idType": "nidn",
"idNumber": "987654321",
"entityType": "individual"
}
},
"amount": 500,
"symbol": {
"handle": "usd"
}
}
]
},
"meta": {
"status": "completed",
"moment": "2025-04-05T14:30:00.050Z",
"owners": [
"RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA="
],
"proofs": [
{
"signer": "tesla-bank-bridge",
"method": "ed25519-v2",
"digest": "6470993982c70f230a95d9084a2ae7b86e612efa57d9f9de9fc379a32923646f",
"public": "RyXTVL6wSgoBMSZRmTnnKBc82dQGLn5y4Nlp8KRwMLA=",
"result": "VUq9NdRZcIk/g85nQTDqsAloXEs6tceZZWw3yPzMeiohjZiZ+FK1lHgQY4haI2C+ZzDMD/lTcqpihKPOq82VBg==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z",
"status": "created"
}
},
{
"signer": "system",
"method": "ed25519-v2",
"digest": "7b75a12a0a9f29fb903461a2c9d1e4d50e7092199c7bef460e6550e09056d7ac",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "rAiwYdEpgfJK7Cd3nYLJgrM/YTKphjh6gPAh6+z2Wm6IYubg+2CbyJAjKSp69T+bQikHqGAYypy2eUTG/7u6CQ==",
"custom": {
"luid": "$int.-01xK0rStT2dS4wX3",
"moment": "2025-04-05T14:30:00.050Z",
"status": "created"
}
},
{
"signer": "system",
"method": "ed25519-v2",
"digest": "9b394cbefa10fb1793133bd4b8f19a5ef4995caf764d12b88dd9036a7d8195a0",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "0q2ZGUegTZJ2NiMQERFln53MPh/sdNI8QhCUrHudd/0giOQePSVvus9z8WXWBCMDMIjrv8AMt8tC5JMHwO5rAQ==",
"custom": {
"moment": "2025-04-05T14:30:20.000Z",
"status": "completed"
}
}
]
}
},
{
"luid": "$int.-01xG28V2qdcBt3fR",
"hash": "eee88032e946d28d62484d70149aa34c96372c93657320fc0cecbacb988ddcd9",
"data": {
"handle": "transfer-1712345679012",
"parent": "be40db4425c914903888398a39519b6e9c9b0e047afd40c64f78c95f8f6d64f1",
"claims": [
{
"action": "transfer",
"source": {
"handle": "tran:1001001234@nova-bank.com",
"custom": {
"name": "Jane Smith",
"idType": "nidn",
"idNumber": "987654321",
"entityType": "individual"
}
},
"target": {
"handle": "svgs:1001001212@tesla-bank.com",
"custom": {
"name": "John Doe",
"idType": "nidn",
"idNumber": "123456789",
"entityType": "individual"
}
},
"amount": 250,
"symbol": {
"handle": "usd"
}
}
]
},
"meta": {
"status": "completed",
"moment": "2025-04-05T14:21:40.025Z",
"owners": [
"uutTMAKf8JvlLjBQy9VaTBFl3Qy95FDqjSQsN74TeBE="
],
"proofs": [
{
"signer": "nova-bank-bridge",
"method": "ed25519-v2",
"digest": "5c4bfe3ac154aae998468b7961e5dc597b03d091022507537b810ce332f68cf6",
"public": "uutTMAKf8JvlLjBQy9VaTBFl3Qy95FDqjSQsN74TeBE=",
"result": "JHKnrB16Agojegpikm15JKLrIuGxhS828n4XNfI6LhzoghcOTy1UaokkHRxlqqLcS0ZRRRVbZ1ZG31fyBwzfBg==",
"custom": {
"moment": "2025-04-05T14:21:40.000Z",
"status": "created"
}
},
{
"signer": "system",
"method": "ed25519-v2",
"digest": "b1956ae299e94564adcb0370094fd6b4f88f2140941db09749a930ca7e165cbf",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "CiquNqpKHT4vgPgoGeJE4Gad9q1Lrfa9AsdYZ7TndWVggCeKCrOAuu/mYNT+r8TIgMHJueWPqzcmqk8UjJigBQ==",
"custom": {
"luid": "$int.-01xG28V2qdcBt3fR",
"moment": "2025-04-05T14:21:40.025Z",
"status": "created"
}
},
{
"signer": "system",
"method": "ed25519-v2",
"digest": "22e913ab06edbdf00f9a89149e940ab79013c4a2eb7bfd3a46852069dbc1276a",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "c0lY7DMSZV1ZXa3Ro4Cu/3r1L1GmV2ZjqeA8laR45HL583/TNmK2TraFW/bd89Qgzt/odm2+BTM75Ks3WEs3Cw==",
"custom": {
"moment": "2025-04-05T14:30:20.000Z",
"status": "completed"
}
}
]
}
}
],
"page": {
"index": 0,
"limit": 20
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "b43b1cbdba6bae080b2afd101b94bc52c62c8c983285768758d35e9354d74da0",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "dnt8OHHP3ADJK3MadX4t4TyiF17t+Yuih/46yVl0UzUTJ+abKhgxNxYLy7FduPuX/rJwXu8mOky36KbFLTA8DQ==",
"custom": {
"moment": "2025-04-05T14:30:00.100Z"
}
}
]
}
}{
"hash": "b7eb7ccf5ffc126951e13e29a8dcfdaf95db859715d4edfc2d16f59a79d4cd58",
"data": {
"reason": "auth.unauthorized",
"detail": "Invalid token."
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "3acece870c4118bfe4223118e4d2f3cfd5b8947a7093785b66d49aa57fa2890a",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "gnK63DqqWDY/UXvnZHixDKPKS6tfeGHgdARylnPiJLwQGyYxuD97TYbSg2wrzsf/bDrHwQYZaf8Gu5ryYP0UAA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "9ec02726b50650add8acfd124c6defeb978a9ac252a5de888f9493ddc701e927",
"data": {
"reason": "auth.forbidden",
"detail": "Request is not authorized"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "4f8cbdc38d73348de0c31805c783c84a0fecc6be736d7e187004ba68cd00e675",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "P3hRnveehtuobb4AIO56XBmiduvmYJbpdmOHltG/IifBEH7QSWdv/0pqled4SO9x1Ne3oXuWxJy40DzMvx1MBA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "bd1e78b47e837376b7994e3e481aa547c110c4d6a1c1d8ecd047cc465edd33bd",
"data": {
"reason": "api.request-timeout",
"detail": "Processing of request on server timed out. Your request may or may not have been processed."
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "cdf5b09c809ec52934cd76ca3b0aa59310049e3cae8b171aee3cf9e0f98bddb2",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "6h1lhq3TOccWrfIdtOa9pkz9pIHVAN9tyXuNaucvLpbspWACog6HpSAdr0FSwGzn0zAKwx8YppGOVjFhfeBLBw==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "1c084e8dcfb9bb84bc8ea96e9e137b149a34b2bbd85f8e60b4263f5aba980476",
"data": {
"custom": {
"errors": [
{
"instancePath": "/handle",
"schemaPath": "#/properties/handle/pattern",
"keyword": "pattern",
"params": {
"pattern": "^[a-zA-Z0-9_\\-+.]+$"
},
"message": "must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
}
]
},
"reason": "record.schema-invalid",
"detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "7a5febb431719b6f43d7e88e79211308e16ac651b71b339276373fdb4e7c3760",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "2/1zYw4AaIzsIHfOIC6V/CHw6owbjYHt48cwmFOig0ibeT0IbojLmj1RCRi8W00ka0udPa9WsacWDd7ObMY8CA==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}{
"hash": "93a5f4d97a42c2df97f827c58ff7768d02568c15aca931e22b81fa3160ba0df3",
"data": {
"reason": "api.unexpected-error",
"detail": "An unexpected error occurred"
},
"meta": {
"proofs": [
{
"signer": "system",
"method": "ed25519-v2",
"digest": "efaf5360143b586917d9636779ad6e08571c5b06909a20dd0f5eba4bf3be7eae",
"public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
"result": "hERh6Aecj59iR+Fb25OQsHJScOi4t8EiffKSfjlMQdjHMccTnfDlgZFdaJzXzUtpSwy/NHq0l+7ydh3HSWCoAg==",
"custom": {
"moment": "2025-04-05T14:30:00.000Z"
}
}
]
}
}Query Parameters
page?
Pagination options. Set limit and index to page through results.
filter?
Filter by field values using dot notation (e.g. data.handle=value). Operators like $in and $regex are optional — equality is the default.
Header Parameters
x-ledger?|
The unique identifier of ledger in context for multi tenant requests.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
Create intent POST
The intent starts in `pending` status and enters the DTC flow. If source or target wallets have bridges assigned, each bridge must prepare the claim before the ledger commits it. Without bridges, the intent transitions through the full lifecycle almost instantly since there is no coordination with external systems. Status policies can customize the lifecycle by defining quorum requirements for each transition or introducing additional statuses. Intents cannot be updated after creation. Use proofs to advance the intent through its lifecycle or to record bridge responses. The handle must be unique within the ledger and can be used as a client-side idempotency key. Broadcasts the `intent-created` signal. Use [effects](/ledger/reference/api/effect) to subscribe.
Get intent GET
The response includes the current DTC status and all proofs collected so far, which can be used to track processing progress.