List documents

curl --request GET \
  --url https://sacra.com/api/v1/documents/ \
  --header 'Authorization: <api-key>'

{
  "documents": [
    {
      "id": 1835,
      "slug": "owner",
      "title": "Owner One-Pager",
      "link": "https://sacra.com/f/3qM9xK2pR7vT8nL4cYwJ6aH1uB5dZ0eQ",
      "web_url": "https://sacra.com/c/owner/",
      "type": "company",
      "date": "2026-01-13",
      "published_at": "2026-01-13",
      "created_at": "2025-03-10T20:42:33.911Z",
      "updated_at": "2026-01-13T21:01:20.492Z",
      "preview_meta": {
        "title": "Owner",
        "image": "https://images.prismic.io/sacra/Z89OKRsAHJWomTQV_owner_logo.jpeg?auto=format,compress",
        "description": "Software suite for restaurants to manage online ordering, websites, marketing, and loyalty"
      },
      "companies": [
        {
          "id": 1486,
          "domain": "owner.com",
          "relation": "subject"
        }
      ]
    }
  ],
  "pagination": {
    "page_size": 30,
    "current_page_items": 1,
    "total_items": 1,
    "next_link": null,
    "prev_link": null,
    "after_cursor": "Start",
    "before_cursor": null
  }
}

Documents

List documents

Returns document summaries with cursor-based pagination.

Two query modes:

Company query — filter by company_domain or company_id to get documents related to a specific company (both subject and connected docs). Returns a flat list with no pagination. Each document includes a top-level relation field.
Global query — omit company filters to search across all documents. Requires a created_at or updated_at date range of 14 days or less. Returns paginated results. Each document includes a companies array with per-company relation.

Use doc_type to filter by one or more comma-separated internal document types, e.g. doc_type=interview,document.

Pagination: Use page_after / page_before cursors (document IDs) for forward and backward navigation. The special values Start and End are supported. Only applies to global queries.

GET

api

documents

List documents

curl --request GET \
  --url https://sacra.com/api/v1/documents/ \
  --header 'Authorization: <api-key>'

{
  "documents": [
    {
      "id": 1835,
      "slug": "owner",
      "title": "Owner One-Pager",
      "link": "https://sacra.com/f/3qM9xK2pR7vT8nL4cYwJ6aH1uB5dZ0eQ",
      "web_url": "https://sacra.com/c/owner/",
      "type": "company",
      "date": "2026-01-13",
      "published_at": "2026-01-13",
      "created_at": "2025-03-10T20:42:33.911Z",
      "updated_at": "2026-01-13T21:01:20.492Z",
      "preview_meta": {
        "title": "Owner",
        "image": "https://images.prismic.io/sacra/Z89OKRsAHJWomTQV_owner_logo.jpeg?auto=format,compress",
        "description": "Software suite for restaurants to manage online ordering, websites, marketing, and loyalty"
      },
      "companies": [
        {
          "id": 1486,
          "domain": "owner.com",
          "relation": "subject"
        }
      ]
    }
  ],
  "pagination": {
    "page_size": 30,
    "current_page_items": 1,
    "total_items": 1,
    "next_link": null,
    "prev_link": null,
    "after_cursor": "Start",
    "before_cursor": null
  }
}

Authorizations

Authorization

string

header

required

Authenticate using one of two formats:

Organization/user token: Token <your-token>
Stytch JWT: Bearer <your-jwt>

Query Parameters

company_domain

string

Company domain to filter by (e.g. stripe.com).

company_id

string

Company ID to filter by.

created_at_gte

string

ISO 8601 lower bound for created_at (inclusive).

created_at_lte

string

ISO 8601 upper bound for created_at (inclusive).

doc_type

string

Comma-separated internal document type filters (e.g. interview,document).

page_after

string

Cursor ID for forward pagination. Cannot combine with page_before.

page_before

string

Cursor ID for backward pagination. Cannot combine with page_after.

page_size

integer

Items per page, 1-100. Default 30. Only for global queries.

updated_at_gte

string

ISO 8601 lower bound for updated_at (inclusive). Recommended for daily polling.

updated_at_lte

string

ISO 8601 upper bound for updated_at (inclusive). Recommended for daily polling.

Response

documents

object[]

required

Show child attributes

pagination

object

Only present in global queries. Null when no results.

Show child attributes

Get a company detail Get a document

⌘I