Sign in

v1

latestOpenAPI 3.1.02026-07-2685154311.7 KB
Transfers

Match transfers by settlement identifiers

get/entities/{entityDID}/tx/match

Path parameters

entityDIDstring did required

Decentralized Identifier (DID)

Example:did:web:vasps.id:jxnl0411:at

The DID of the entity

Query parameters

settlement_idstring required

Settlement identifier (e.g., tx hash).

settlement_addressstring required

Settlement address, preferably in CAIP-10 format (e.g., eip155:1:0x...). CAIP-10 addresses get deep validation; plain addresses pass through as-is.

source_addressstring

Sender address in CAIP-10 format (e.g., xrpl:0:rAddr:123456). Embedded memo tags are extracted and used for matching.

assetAssetIdentifier[]

Filter transfers by asset identifier

[
  "bip122:000000000019d6689c085ae165831e93/slip44:0"
]
settlement_id_indexstring

Optional index (vout/log index). Used for strict match; dropped in broadened search if strict fails.

memo_tagstring

Memo tag for matching

limitinteger

Maximum number of transfers to return

offsetinteger

Number of transfers to skip

direction'INCOMING' | 'OUTGOING'

The direction of a transfer relative to the entity

Filter transfers by direction

fieldsstring

Comma-separated list of fields to include in the response.

sort_bystring

Field to sort by

sort_order'asc' | 'desc'

Sort order (asc or desc)

Response

Match results retrieved successfully

Example response

{
  "data": [
    {
      "originator": {
        "@id": "did:web:originator.example.com"
      },
      "beneficiary": {
        "@id": "did:web:beneficiary.example.com"
      },
      "agents": [
        {
          "@id": "e6630d6a-5e3d-4a23-a638-94a1f4c2893b",
          "@type": "TransferAgent",
          "agent": {
            "@id": "did:web:vasp.example.com"
          },
          "name": "Example VASP",
          "for": "did:web:customer.example.com",
          "role": "VASP",
          "status": "PROCESSING",
          "relationship": {}
        }
      ]
    }
  ]
}