Skip to content

Get Trade Confirmation

Request

Get a trade's trade confirmation.


Trade confirmations are sensitive documents. For security reasons, we return trade confirmations as PDFs through a URL with a 10-minute TTL. Trade confirmation PDFs should be fetched and served just-in-time, not stored in databases. Trades with "activity": "MATURITY" do not have trade confirmations.

Security
HTTPBearer
Path
account_idstring, (uuid)(Account Id)required
trade_idstring, (uuid)(Trade Id)required
Headers
x-jiko-idempotencystring, (uuid)(X-Jiko-Idempotency)required

A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

x-jiko-signaturestring(X-Jiko-Signature)required

Base64-encoded HMAC-SHA256 hash of x-jiko-idempotency + request pathname + body, keyed with your shared secret. See Authentication for the full algorithm and a code sample.

curl -i -X GET \
  'https://your-partner-name.sandbox-api.jikoservices.com/api/v1/jiko-accounts/{account_id}/trades/{trade_id}/confirmation/' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'x-jiko-idempotency: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \
  -H 'x-jiko-signature: string'

Responses

Successful Response

Bodyapplication/json
urlstring, (uri), [ 1 .. 2083 ] characters(Url)required
Example:"https://example.com/path-to-trade-confirmation-pdf"
object_typestring(Object Type)read-onlyrequired
Response
{ "url": "https://example.com/path-to-trade-confirmation-pdf" }