Records

Write record

Write a record transaction to the blockchain.

The transaction will be published to the blockchain asynchronously. Use Get linked record status to find out when it has been confirmed.

POST{your-URL}/api/v1/records

Query parameters

Header parameters

Body

application/octet-stream

Record to be included in the transaction output as an application/octet-stream

string (byte)

Response

200400500

The transaction has been published. The response is a JSON structure, containing the following details:

• txId: the transaction Id which is required by subsequent commands and can also be used by external tools
• encoding: array of encoding steps (omitted when encoders are not used), each element defines:
  • contentType: output content type
  • output: if content type is text, it will include up to 1024 characters of the output (omitted for binary content types)

Body

text/plainapplication/jsontext/json

txIdnullable string

fingerprintnullable string (byte)

Request

JavaScriptCurlPython

const response = await fetch('{your-URL}/api/v1/records', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/octet-stream"
    },
    body: JSON.stringify("Ynl0ZXM="),
});
const data = await response.json();

Response

200400500

{
  "txId": "text",
  "fingerprint": "Ynl0ZXM="
}