Transactions

Submit sender (originator) information for a deposit parked on UNREGISTERED_ADDRESS

Two paths: register=false records sender data for this deposit only; register=true also creates a durable RegisteredAddress (at end-of-flow on Sardine APPROVE) that resolves any future deposits from the same address. First-snapshot wins — once recorded, a second submission returns 409. Returns 202 with the transaction in its post-signal state; poll GET /v2/transactions/:id for downstream updates.

POST

transactions

{transactionId}

sender-information

Submit sender (originator) information for a deposit parked on UNREGISTERED_ADDRESS

curl --request POST \
  --url https://api.conduit.financial/v2/transactions/{transactionId}/sender-information \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "originator": {
    "entityType": "BUSINESS",
    "legalName": "<string>",
    "country": "<string>"
  },
  "register": false,
  "label": "<string>"
}
'

{}

Authorizations

x-api-key

string

header

required

Headers

Idempotency-Key

string

required

Caller-generated unique key that lets the server safely replay this request. The cached response is returned for 5 minutes on any retry with the same key from the same API principal. Required on every state-changing money-moving or resource-creating POST.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9_.:-]{1,128}$

Path Parameters

transactionId

string

required

Body

application/json

originator

object

required

Option 1
Option 2

Show child attributes

boolean

default:false

label

string

Maximum string length: 255

Response

The response is of type object.

List transactionsReturns a paginated list of the caller's transactions. Filter by type, status, customer, asset, chain, transaction hash, linked order, or creation timestamp. Sorted by `createdAt desc` by default; use `sortBy` and `sortOrder` to override.

⌘I

Submit sender (originator) information for a deposit parked on UNREGISTERED_ADDRESS

curl --request POST \
  --url https://api.conduit.financial/v2/transactions/{transactionId}/sender-information \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "originator": {
    "entityType": "BUSINESS",
    "legalName": "<string>",
    "country": "<string>"
  },
  "register": false,
  "label": "<string>"
}
'

{}