Skip to main content
POST
TypeScript

Headers

Idempotency-Key
string

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Path Parameters

offerId
string
required

The Fireblocks transaction id of the incoming offer being answered.

Example:

"5a1d8b0f-2c31-4c7e-9d0a-118e7b6c4a21"

Body

application/json

Accept a DTCC end-investor onboarding offer. Carries no arguments.

responseType
enum<string>
required

How you are answering the offer — one of the offer transaction's cantonDetails.offerResponse.availableResponses. That list does not change after the offer arrives; check expiresAt and the transaction status to see whether it is still answerable.

Available options:
DTCC_END_INVESTOR_ONBOARDING_ACCEPT
Example:

"DTCC_END_INVESTOR_ONBOARDING_ACCEPT"

Response

The outgoing transaction that carries the response. Its on-chain outcome arrives by webhook as a status update on this transaction.

The outgoing transaction that carries the response. Its on-chain outcome arrives by webhook as a status update on this transaction.

transactionId
string
required

The outgoing response transaction.

Example:

"5a1d8b0f-2c31-4c7e-9d0a-118e7b6c4a21"

status
string
required

The transaction's status at the time of this response — SUBMITTED.

Example:

"SUBMITTED"

responseType
string
required

The response type you sent, echoed back so you can correlate without re-reading.

Example:

"DTCC_END_INVESTOR_ONBOARDING_REJECT"