Requests

List requests

get

Authorizations

Query parameters

pageany ofOptional

Which page to fetch

Default: 1

notOptional

or

integer · min: 1Optional

pageSizeany ofOptional

Page size to use

Default: 30

notOptional

or

integer · min: 1 · max: 30Optional

typestring · enumOptional

Search by request type

Possible values:

statestring · enumOptional

Search by request state

Possible values:

createdBystringOptional

reviewedBystringOptional

pendingBystringOptional

sortBystring · enumOptional

Sort by attribute

Default: createdAtPossible values:

sortOrderstring · enumOptional

Sort order

Default: ascPossible values:

Responses

200

Successful response

application/json

default

Error response

application/json

get

HTTPcURLJavaScriptPython

GET /rest/requests HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "page": 1,
  "next": 1,
  "prev": 1,
  "pageSize": 1,
  "total": 1,
  "results": [
    {
      "type": "UPDATE_QUORUM",
      "data": {
        "quorum": 1
      },
      "id": "text",
      "legacyId": 1,
      "state": "INITIAL",
      "reviewSteps": [
        {
          "stageName": "text",
          "quorum": 1
        }
      ],
      "currentStepIndex": 1,
      "expiredAt": "2025-06-21T05:32:16.208Z",
      "targetId": "text",
      "reviews": [
        {
          "stepIndex": 1,
          "userId": "text",
          "status": "PENDING",
          "createdAt": "2025-06-21T05:32:16.208Z",
          "updatedAt": "2025-06-21T05:32:16.208Z"
        }
      ],
      "createdAt": "2025-06-21T05:32:16.208Z",
      "updatedAt": "2025-06-21T05:32:16.208Z"
    }
  ]
}

Create a request

post

Body

requestany ofRequired

or

or

or

or

or

or

or

or

or

or

or

or

Responses

200

Successful response

application/json

Responseany of

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

default

Error response

application/json

post

HTTPcURLJavaScriptPython

POST /rest/requests HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 733

{
  "request": {
    "type": "CREATE_ADMIN",
    "data": {
      "name": "text",
      "deviceType": "PSD",
      "deviceUserId": "text",
      "registration": {
        "subState": "PENDING",
        "deviceData": {
          "name": "text",
          "psdModel": "BLUE",
          "pubKey": "text",
          "confidentialityKey": "text",
          "psdEphemeralKey": "text",
          "psdEphemeralKeyAttestation": {
            "codeHash": "text",
            "attestationPub": "text",
            "certificate": "text",
            "signature": "text"
          }
        },
        "challenge": {
          "challenge": "text",
          "ephemeralPublicKey": "text",
          "ephemeralPublicKeyAttestation": {
            "codeHash": "text",
            "attestationPub": "text",
            "certificate": "text",
            "signature": "text"
          },
          "handshake": "text",
          "handshakeAttestation": {
            "codeHash": "text",
            "attestationPub": "text",
            "certificate": "text",
            "signature": "text"
          },
          "u2fRegisterData": "text",
          "ciphertext": "text",
          "requestId": "text"
        }
      }
    }
  }
}

{
  "type": "UPDATE_QUORUM",
  "data": {
    "quorum": 1
  },
  "id": "text",
  "legacyId": 1,
  "state": "INITIAL",
  "reviewSteps": [
    {
      "stageName": "text",
      "quorum": 1
    }
  ],
  "currentStepIndex": 1,
  "expiredAt": "2025-06-21T05:32:16.208Z",
  "targetId": "text",
  "reviews": [
    {
      "stepIndex": 1,
      "userId": "text",
      "status": "PENDING",
      "createdAt": "2025-06-21T05:32:16.208Z",
      "updatedAt": "2025-06-21T05:32:16.208Z"
    }
  ],
  "createdAt": "2025-06-21T05:32:16.208Z",
  "updatedAt": "2025-06-21T05:32:16.208Z"
}

Get a request by ID

get

Authorizations

Path parameters

idstringRequired

Id of the request

Responses

200

Successful response

application/json

Responseany of

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

or

default

Error response

application/json

get

HTTPcURLJavaScriptPython

GET /rest/requests/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "type": "UPDATE_QUORUM",
  "data": {
    "quorum": 1
  },
  "id": "text",
  "legacyId": 1,
  "state": "INITIAL",
  "reviewSteps": [
    {
      "stageName": "text",
      "quorum": 1
    }
  ],
  "currentStepIndex": 1,
  "expiredAt": "2025-06-21T05:32:16.208Z",
  "targetId": "text",
  "reviews": [
    {
      "stepIndex": 1,
      "userId": "text",
      "status": "PENDING",
      "createdAt": "2025-06-21T05:32:16.208Z",
      "updatedAt": "2025-06-21T05:32:16.208Z"
    }
  ],
  "createdAt": "2025-06-21T05:32:16.208Z",
  "updatedAt": "2025-06-21T05:32:16.208Z"
}