List approvals

Your Company APIApprovals

GEThttps://api.your-company.example/v1/matters/{matter_id}/approvals

AuthenticationRequires bearerAuth.

Description

Returns approval requests for a Matter, newest first.

Request

curl "https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/approvals?limit=20&cursor=string" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/approvals?limit=20&cursor=string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
  },
});

import requests

response = requests.get(
    "https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/approvals",
    params={
      "limit": "20",
      "cursor": "string"
    },
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response200JSON

{
  "data": [
    {
      "id": "apr_01JAZ8M2F7",
      "matter_id": "mat_01JAZ6Q7K2",
      "document_id": "doc_01JAZ7C3V9",
      "chain_id": "ach_01J8X2V6N1",
      "stage": 1,
      "status": "pending",
      "requested_by": "usr_01J9M4X8D2",
      "requested_at": "2026-07-12T15:20:00Z",
      "due_at": "2026-07-14T23:59:59Z",
      "decision": null
    }
  ],
  "next_cursor": null
}

Parameters

matter_idpathstringrequired

Matter identifier.

limitqueryintegerdefault: 20

Maximum number of records to return, from 1 to 100.

cursorquerystring

Opaque cursor from the previous page response.

Responses

200A page of approval requests.application/json

dataobject[]required

Array item fields

idstringrequired

matter_idstringrequired

document_idstringrequired

chain_idstringrequired

stageintegerrequired

statusstringrequired

Allowed values: pendingapprovedrejectedcanceled

summarystring | null

requested_bystringrequired

requested_atstring <date-time>required

due_atstring | null

decided_bystring | null

decided_atstring | null

decisionstring | null

Allowed values: approvedrejectednull

decision_notestring | null

next_cursorstring | nullrequired

Example response

{
  "data": [
    {
      "id": "apr_01JAZ8M2F7",
      "matter_id": "mat_01JAZ6Q7K2",
      "document_id": "doc_01JAZ7C3V9",
      "chain_id": "ach_01J8X2V6N1",
      "stage": 1,
      "status": "pending",
      "requested_by": "usr_01J9M4X8D2",
      "requested_at": "2026-07-12T15:20:00Z",
      "due_at": "2026-07-14T23:59:59Z",
      "decision": null
    }
  ],
  "next_cursor": null
}

401The API key is missing, malformed, expired, or revoked.application/json

errorobjectrequired

Object fields

codestringrequired

Stable machine-readable error code.

messagestringrequired

Human-readable summary.

request_idstringrequired

Identifier to include in a support ticket.

detailsobject[]

Array item fields

fieldstringrequired

Request field with an issue.

issuestringrequired

Human-readable validation problem.

Example response

{
  "error": {
    "code": "unauthorized",
    "message": "Provide a valid bearer API key.",
    "request_id": "req_01JAZA0P8M"
  }
}

404The resource was not found in the authenticated Workspace.application/json

errorobjectrequired

Object fields

codestringrequired

Stable machine-readable error code.

messagestringrequired

Human-readable summary.

request_idstringrequired

Identifier to include in a support ticket.

detailsobject[]

Array item fields

fieldstringrequired

Request field with an issue.

issuestringrequired

Human-readable validation problem.

Example response

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found.",
    "request_id": "req_01JAZA0P8M"
  }
}