API Reference
GETRequires X-API-Key

List settlements by reference

GET /uda/settlements/by-reference

Look up settlements by a reference you already know. The reference is currently the on-chain deposit transaction id that funded the settlement — useful when you know what you paid with but not the internal settlement id. A single deposit transaction can fund multiple settlements, so the response is always a list (empty when nothing matches).

Query parameters

NameTypeDescription
referencerequiredstringLookup reference (on-chain deposit transaction id).

Responses

Matching settlements.

  • referencestring

    The reference that was looked up.

  • countinteger
    • idstring
    • uda_idstring
    • statusstringenum: created · routing · completed · failed · retrying
    • created_atstringformat: date-time
    • updated_atstringformat: date-time
    • errorstring

      Failure reason when `status` is `failed`; empty otherwise.

Request
curl "https://api.stridge.dev/v1/uda/settlements/by-reference?reference=string" \
  -H "X-API-Key: $STRIDGE_API_KEY"

Set your key as STRIDGE_API_KEY (sent as X-API-Key).

Response200
"reference": "0xab12cd34ef56...7890",
"count": 1,
"id": "stl_71829304a5b6c7d8",
"uda_id": "uda_2f8c1a9d4e5f6071",
"status": "completed",
"created_at": "2026-05-29T11:58:41Z",
"updated_at": "2026-05-29T11:59:25Z",
"error": "",
"address": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3",
"amount": "1000000",
"asset_symbol": "USDC",
"asset_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"network_id": 1,
"network_name": "Ethereum",
"tx_hash": "0xab12cd34ef56...7890",
"confirmed_at": "2026-05-29T11:58:40Z"
},
"address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
"amount": "998500",
"asset_symbol": "USDC",
"asset_address": "0x55d398326f99059fF775485246999027B3197955",
"network_id": 56,
"network_name": "BNB Smart Chain",
"tx_hash": "0xcd34ef5678...90ab",
"settled_at": "2026-05-29T11:59:25Z"
},
"total": "1500",
"platform": "1500",
"provider": "0",
"fee_amount": "1500"
},
"provider": "lifi",
"type": "cross_chain_swap",
"time_ms": 45000
}
}
]
}