Documentation Index
Fetch the complete documentation index at: https://docs.sacra.com/llms.txt
Use this file to discover all available pages before exploring further.
This changelog summarizes the additive changes to /documents, /news/company, and /events that enable content synchronization workflows. For a practical guide using these features, see Sync Sacra Research & Data.
Common additions
All three endpoints now support:
- Time filters:
created_at_gte, created_at_lte, updated_at_gte, updated_at_lte
- Cursor pagination (documents and news by default, events via
pagination=cursor): page_after, page_before, page_size
Cursor pagination responses include next_link / prev_link and cursor metadata.
Cursor links URL-encode date values (e.g., : becomes %3A), which is expected. For daily polls, use a 24-hour window (tight date range).
Documents
Additions:
- Global GET (no company params required)
created_at_gte/lte and updated_at_gte/lte filters- Cursor pagination (
page_after, page_before, page_size)
- Global responses include
companies array with relation (subject/connected)
- Company-scoped responses now include
published_at, created_at, updated_at
Global documents (no company params)
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sacra.com/api/v1/documents?updated_at_gte=2026-01-13T00:00:00Z&updated_at_lte=2026-01-14T00:00:00Z"
{
"documents": [
{
"id": 1835,
"slug": "owner",
"title": "Owner One-Pager",
"link": "https://sacra-pdfs.s3.us-east-2.amazonaws.com/owner.pdf",
"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/...",
"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
}
}
Company-scoped documents
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sacra.com/api/v1/documents?company_domain=owner.com&updated_at_gte=2026-01-13T00:00:00Z&updated_at_lte=2026-01-14T00:00:00Z"
{
"documents": [
{
"id": 1835,
"slug": "owner",
"title": "Owner One-Pager",
"link": "https://sacra-pdfs.s3.us-east-2.amazonaws.com/owner.pdf",
"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/...",
"description": "Software suite for restaurants to manage online ordering, websites, marketing, and loyalty"
},
"relation": "subject"
}
]
}
News
Additions:
created_at_gte/lte and updated_at_gte/lte filters (aliases for existing created_at filters)company object per item (id, domain)- Domain-less queries require a date window of 14 days or less
Use daily polling with a 24-hour date window for domain-less queries.
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sacra.com/api/v1/news/company?updated_at_gte=2026-01-13T00:00:00Z&updated_at_lte=2026-01-14T00:00:00Z"
{
"company_news": [
{
"id": "997bdd91-ec86-4f54-ac46-671eb50ec214",
"release_date": "2026-01-13T10:37:38Z",
"headline": "Balderton Capital Cashes Out $2 Billion From Revolut Stake",
"short_headline": "Balderton Cashes $2B",
"description": "It led Revolut's first funding round and has cashed out about $2bn...",
"created_at": "2026-01-13T12:24:06.621470Z",
"updated_at": "2026-01-13T12:24:06.621479Z",
"articles": [
{
"id": "0681f131-b451-43d6-a3f6-c857060021ee",
"link": "https://ft.com/content/e19a419f-5c81-4326-8f41-478e90c7211a",
"headline": "The London investor making billions from Revolut",
"short_summary": "The VC firm Balderton Capital is cashing in on its home-run bet on the fintech",
"date_published": "2026-01-14T05:00:31Z",
"thumbnail": "...",
"publication": "Financial Times",
"publication_score": 200
}
],
"company": { "id": 407, "domain": "revolut.com" }
}
],
"pagination": {
"page_size": 10,
"current_page_items": 7,
"total_items": 7,
"next_link": null,
"prev_link": null,
"after_cursor": "Start",
"before_cursor": null
},
"meta": {
"query_type": "domain-less",
"companies_count": 1276,
"companies": null
}
}
Events
Additions:
created_at_gte/lte and updated_at_gte/lte filters- Cursor pagination via
pagination=cursor
- Cursor pagination metadata aligned with documents/news (
next_link, prev_link, cursors)
Cursor pagination is opt-in via pagination=cursor. Page-based pagination remains the default.
curl -H "Authorization: Token YOUR_API_KEY" \
"https://sacra.com/api/v1/events?pagination=cursor&updated_at_gte=2026-01-13T00:00:00Z&updated_at_lte=2026-01-14T00:00:00Z"
{
"events": [
{
"event_id": "st_0c601c12-6213-4093-8e5b-90febbb1056e",
"event_type": "secondary_transaction",
"event_subtype": "institutional_secondary",
"event_name": "Direct Sale (2025)",
"event_date": "2025-09-01",
"event_status": "closed",
"event_last_updated_at": "2026-01-13T18:03:42.923112+00:00",
"company": { "id": "407", "slug": "revolut", "domain": "revolut.com" },
"data": {
"id": "0c601c12-6213-4093-8e5b-90febbb1056e",
"updated_at": "2026-01-13T18:03:42.923112+00:00",
"name": "Direct Sale (2025)",
"transaction_type": "institutional_secondary",
"transaction_amount": "1000000000.00",
"currency": "USD",
"valuation": "75000000000.00",
"price_per_share": "1381.06",
"announced_date": "2025-09-01",
"closing_date": "2025-09-05",
"created_at": "2025-10-24T01:19:34.954929+00:00",
"equities": [],
"status": "closed"
}
}
],
"pagination": {
"page_size": 30,
"current_page_items": 1,
"total_items": 1,
"after_cursor": "Start",
"before_cursor": null,
"next_link": null,
"prev_link": null
}
}
Notes
- All changes are additive. Existing clients can continue using company-scoped queries and page-based events pagination.
- Cursor pagination responses use endpoint-specific
next_link and prev_link URLs.
- Document content (document elements/body) is still served by the document content endpoint, not the global documents list.
