Transaction request

Transaction request API specification

Generate 🔓

To create a transaction request as a dApp, you will need to provide a sign in token and a transaction.

A partial transaction is a transaction with the TransactionSkeletonType format specified in the library Lumos. You need to attach the necessary fields that you want your transaction to have so that it can be processed by the API.

Each transaction request has 7 days to be signed or rejected before it expires.

post

Create a new transaction request with a signInToken and a transaction object

Header parameters

Content-Typestring · default: "application/json"required

application/json

x-timestampstringoptional

The timestamp of the request

x-signaturestringoptional

The signature of the request

x-api-keystringoptional

The API key of the dApp

Body

signInTokenstringrequired

The signIn token that was used to create the transaction request

transactionobject · default: {"cellProvider":null,"cellDeps":[],"headerDeps":[],"inputs":[],"outputs":[],"witnesses":[],"fixedEntries":[],"signingEntries":[],"inputSinces":{}}required

The transaction request content

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/api/transaction-request' \
  --header 'Content-Type: application/json' \
  --data '{
    "signInToken": "text",
    "transaction": {}
  }'

201

403

404

201

{
  "id": 1,
  "transactionToken": "text",
  "status": "pending",
  "transaction": {
    "id": 1,
    "transactionHash": "text",
    "transaction": {}
  },
  "createdAt": "2025-04-03T08:26:27.919Z",
  "expiresAt": "2025-04-03T08:26:27.919Z",
  "signInRequest": {
    "id": 1,
    "signInToken": "text",
    "status": "pending",
    "createdAt": "2025-04-03T08:26:27.919Z",
    "expiresAt": "2025-04-03T08:26:27.919Z",
    "sessionExpiresAt": "2025-04-03T08:26:27.919Z"
  }
}

Remember that to create a transaction request successfully you need to provide a signed sign in token. If the provided token is not signed your request will be rejected.

This is a protected call which uses API authentication. See how to implement it in API authentication section.

Get

With the provided transaction token, this method will return all pertinent information from the transaction request, including the sign in request and transaction data

get

Path parameters

transactionTokenstringrequired

Transaction request identifier

Header parameters

Content-Typestring · default: "application/json"required

application/json

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/api/transaction-request/{transactionToken}' \
  --header 'Content-Type: text'

200

200

{
  "id": 1,
  "transactionToken": "text",
  "status": "pending",
  "transaction": {
    "id": 1,
    "transactionHash": "text",
    "transaction": {}
  },
  "createdAt": "2025-04-03T08:26:27.919Z",
  "expiresAt": "2025-04-03T08:26:27.919Z",
  "signInRequest": {
    "id": 1,
    "signInToken": "text",
    "status": "pending",
    "createdAt": "2025-04-03T08:26:27.919Z",
    "expiresAt": "2025-04-03T08:26:27.919Z",
    "sessionExpiresAt": "2025-04-03T08:26:27.919Z"
  }
}