List Matters

Your Company APIMatters

GEThttps://api.your-company.example/v1/matters

AuthenticationRequires bearerAuth.

Description

Returns Matters in the authenticated Workspace, newest first by default.

Request

curl "https://api.your-company.example/v1/matters?limit=20&cursor=string&status=draft&owner_id=usr_01J9M4X8D2&updated_after=2024-01-01T00%3A00%3A00Z" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.your-company.example/v1/matters?limit=20&cursor=string&status=draft&owner_id=usr_01J9M4X8D2&updated_after=2024-01-01T00%3A00%3A00Z", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
  },
});

import requests

response = requests.get(
    "https://api.your-company.example/v1/matters",
    params={
      "limit": "20",
      "cursor": "string",
      "status": "draft",
      "owner_id": "usr_01J9M4X8D2",
      "updated_after": "2024-01-01T00:00:00Z"
    },
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response200JSON

{
  "data": [
    {
      "id": "mat_01JAZ6Q7K2",
      "name": "Example Counterparty services agreement",
      "agreement_type": "Master services agreement",
      "counterparty_name": "Example Counterparty, Inc.",
      "status": "negotiating",
      "owner_id": "usr_01J9M4X8D2",
      "target_signature_date": "2026-08-28",
      "created_at": "2026-07-08T16:24:00Z",
      "updated_at": "2026-07-11T19:42:13Z"
    }
  ],
  "next_cursor": "eyJ1cGRhdGVkX2F0IjoiMjAyNi0wNy0xMSJ9"
}

Parameters

limitqueryintegerdefault: 20

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

cursorquerystring

Opaque cursor from the previous page response.

statusquerystring

Allowed values: draftnegotiatingawaiting_approvalready_for_signatureexecutedclosed

Return only Matters in this lifecycle status.

owner_idquerystring

Return only Matters assigned to this Workspace member.

updated_afterquerystring <date-time>

Return Matters updated after this ISO 8601 timestamp.

Responses

200A page of Matters.application/json

dataobject[]required

Array item fields

idstringrequired

Stable Matter identifier

namestringrequired

Human-readable Matter name

agreement_typestringrequired

Workspace-defined contract category

counterparty_namestringrequired

Other contracting party

statusstringrequired

Allowed values: draftnegotiatingawaiting_approvalready_for_signatureexecutedclosed

Current lifecycle state of a Matter.

owner_idstringrequired

Workspace member responsible for the Matter

template_idstring | null

Template used for the first draft

target_signature_datestring | null

Internal target for signature

external_referencestring | null

Identifier from a connected business system

current_turn_numberinteger

Latest completed Turn number

executed_copy_idstring | null

Final signed document when execution is complete

created_atstring <date-time>required

Creation timestamp.

updated_atstring <date-time>required

Most recent update timestamp.

next_cursorstring | nullrequired

Cursor for the next page

Example response

{
  "data": [
    {
      "id": "mat_01JAZ6Q7K2",
      "name": "Example Counterparty services agreement",
      "agreement_type": "Master services agreement",
      "counterparty_name": "Example Counterparty, Inc.",
      "status": "negotiating",
      "owner_id": "usr_01J9M4X8D2",
      "target_signature_date": "2026-08-28",
      "created_at": "2026-07-08T16:24:00Z",
      "updated_at": "2026-07-11T19:42:13Z"
    }
  ],
  "next_cursor": "eyJ1cGRhdGVkX2F0IjoiMjAyNi0wNy0xMSJ9"
}

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"
  }
}