Skip to main content
POST
/
api
/
v1
/
filings
Get company filings (POST)
curl --request POST \
  --url https://sacra.com/api/v1/filings/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_id": 123,
  "company_domain": "<string>",
  "filing_type": "<string>",
  "filed_at_start": "2023-11-07T05:31:56Z",
  "filed_at_end": "2023-11-07T05:31:56Z"
}
'
{
  "filings": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "type": "<string>",
      "format": "<string>",
      "region": "<string>",
      "filed_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "url": "<string>"
    }
  ],
  "meta": {
    "company_id": "<string>",
    "company_domain": "<string>",
    "company_name": "<string>",
    "filing_type_filter": "<string>"
  },
  "pagination": {
    "next": "<string>",
    "previous": "<string>",
    "page_size": 123,
    "current_page_items": 123
  }
}

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.

Authorizations

Authorization
string
header
required

Authenticate using one of two formats:

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

Body

company_id
integer

Internal ID of the company. Takes priority over company_domain.

company_domain
string

Domain of the company (e.g. spacex.com).

filing_type
string

Filter by filing type (e.g. 10-K).

filed_at_start
string<date-time>

Filter filings filed on or after this datetime (ISO 8601).

filed_at_end
string<date-time>

Filter filings filed on or before this datetime (ISO 8601).

Response

Paginated list of filings for the company. Same shape as GET.

filings
object[]
required
meta
object
required
pagination
object