Get a document

Your Company APIDocuments

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

AuthenticationRequires bearerAuth.

Description

Returns document metadata and a short-lived download URL.

Request

curl "https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/documents/doc_01JAZ7C3V9" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/documents/doc_01JAZ7C3V9", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
  },
});

import requests

response = requests.get(
    "https://api.your-company.example/v1/matters/mat_01JAZ6Q7K2/documents/doc_01JAZ7C3V9",
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response200JSON

{
  "id": "doc_01JAZ7C3V9",
  "matter_id": "mat_01JAZ6Q7K2",
  "name": "Example Counterparty MSA v3.docx",
  "kind": "draft",
  "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "size_bytes": 284219,
  "version_number": 3,
  "created_at": "2026-07-11T19:40:02Z",
  "download_url": "https://downloads.your-company.example/doc_01JAZ7C3V9?token=temporary",
  "download_expires_at": "2026-07-12T18:15:00Z"
}

Parameters

matter_idpathstringrequired

Matter identifier.

document_idpathstringrequired

Document identifier within the Matter.

Responses

200The document and download details.application/json

idstringrequired

matter_idstringrequired

namestringrequired

kindstringrequired

Allowed values: draftredlinesupportingexecuted_copy

Role of a document in the Matter.

media_typestringrequired

Media type detected during upload.

size_bytesintegerrequired

File size in bytes.

version_numberintegerrequired

Sequential version within its document history.

source_document_idstring | null

Prior version when applicable.

created_atstring <date-time>required

download_urlstring <uri>required

Short-lived authenticated download URL.

download_expires_atstring <date-time>required

Time after which the URL is invalid.

Example response

{
  "id": "doc_01JAZ7C3V9",
  "matter_id": "mat_01JAZ6Q7K2",
  "name": "Example Counterparty MSA v3.docx",
  "kind": "draft",
  "media_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "size_bytes": 284219,
  "version_number": 3,
  "created_at": "2026-07-11T19:40:02Z",
  "download_url": "https://downloads.your-company.example/doc_01JAZ7C3V9?token=temporary",
  "download_expires_at": "2026-07-12T18:15:00Z"
}

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