> ## 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.

# List companies - Companies API

> Discover Sacra's company coverage, retrieve one company, or find companies with recently updated data.

Use this endpoint to discover the companies Sacra covers or identify companies
whose research and data changed during a time window. The request supports three
response modes:

| Goal | Request | Response |
| - | - | - |
| List Sacra's company coverage | Omit all query parameters | A `companies` collection with each company's ID, name, and domain |
| Retrieve one company | Pass `company_domain`, `id`, or `company_slug` | A full `company` detail object |
| Find recently updated companies | Pass `mode=sync` and an update window | A paginated `companies` collection with update metadata |

> [!NOTE]
>
> Looking for one company? See [Get company detail](https://docs.sacra.com/api-reference/companies/get-a-company-detail.md)
> for lookup by domain, ID, or slug. The query identifier parameters shown below
> return a single `company` object rather than filtering the collection.

> [!WARNING]
>
> Provide exactly one of `company_domain`, `id`, or `company_slug`. Do not
> combine a company identifier with `mode=sync`.

## List company coverage

Call the endpoint without query parameters to return all active companies in
Sacra's coverage universe. The lightweight response is useful for populating a
company picker or building a local mapping between company IDs and domains.

```bash theme={null}
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/companies/"
```

## Find recently updated companies

Set `mode=sync` to find companies whose selected data sources changed during an
ISO 8601 time window. Each result includes `updated_at` and `updated_sources`, so
you can decide which company or downstream resource to refresh. A sync window
can span no more than 14 days.

Use `sources` to monitor one or more comma-separated sources, such as
`documents,news,metrics`. Use `sources=all` to include every supported source.

```bash theme={null}
curl -H "Authorization: Token YOUR_API_KEY" \
  "https://sacra.com/api/v1/companies/?mode=sync&updated_at_gte=2026-08-11T00:00:00Z&updated_at_lte=2026-08-12T00:00:00Z&sources=all"
```

Sync responses contain up to 30 companies by default and support a maximum page
size of 100. Follow `pagination.next_link` until it is `null` to retrieve every
company in the window. The link preserves the time window, source filters, page
size, and cursor for the next request.


## OpenAPI

````yaml openapi.json GET /api/v1/companies/
openapi: 3.0.3
info:
  title: Sacra API
  version: 1.0.0
  description: >-
    The Sacra API currently supports querying News, Documents, Companies and
    Categories that enable you to use Sacra research within your own
    application.


    ## **Getting started guide**


    To start using the APIs, you need to:


    - Only available to **Platforms** and **Funds** tier members. (See
    [here](https://sacra.com/pricing/))
        
    - You must use a valid API Key to send requests to the API endpoints. You
    can generate your API key in the Api Keys section of your [Organization
    Settings](https://sacra.com/orgs/settings/general/).
        
    - The API returns request responses in JSON format. When an API request
    returns an error, it is sent in the JSON response as an error key.
        

    ## Authentication


    The Sacra API uses Tokens for authentication.


    You can generate a Sacra API Key/Token in the Api Keys section of your
    [Organization Settings](https://sacra.com/orgs/settings/general/).


    You must include an API Key/Token in each request to the Sacra API with the
    **Authorization** request header.


    ### Authentication error response


    If a Token is missing, malformed, or invalid, you will receive an HTTP 401
    Unauthorized response code.


    ### **Need some help?**


    In case you have questions, we will eventually provide tutorials and a FAQ
    page. But for now you can check out the
    [#developers](https://discord.gg/mTswyV8gg3) channel in our community
    [Discord](https://discord.gg/mTswyV8gg3), there’s a good chance our
    community has an answer for you.


    ## Authorization


    | **Key** | **Value** |

    | --- | --- |

    | Authorization | Token {{API_KEY}} |
servers:
  - url: https://sacra.com
    description: Production
security: []
tags:
  - name: Companies
  - name: Categories
  - name: Events
  - name: News
  - name: Documents
  - name: Filings
  - name: Embeds
  - name: Metrics
  - name: Funding (Legacy)
paths:
  /api/v1/companies/:
    get:
      tags:
        - Companies
      summary: List companies
      description: >-
        List companies, retrieve one company's full detail payload by query
        identifier, or query sync pages of recently updated companies.


        **Single-company lookup:** Pass `id`, `company_domain`, or
        `company_slug`. These parameters return a single `company` object rather
        than a `companies` list and cannot be combined with `mode=sync`. If you
        provide more than one identifier, precedence is `company_slug`, then
        `id`, then `company_domain`.


        For sync mode, call `/api/v1/companies/?mode=sync` with `updated_at_gte`
        and optionally `updated_at_lte` and `sources`. Supported `sources`
        values are `documents`, `news`, `events`, `datasets`, `metrics`,
        `filings`, `listings`, and `all`.
      operationId: companies_list
      parameters:
        - in: query
          name: company_domain
          schema:
            type: string
          description: >-
            Company domain to look up (for example, `stripe.com`). Returns the
            full detail payload. Cannot be combined with `mode=sync`.
        - in: query
          name: company_slug
          schema:
            type: string
          description: >-
            Company slug to look up (for example, `stripe`). Returns the full
            detail payload. Cannot be combined with `mode=sync`.
        - in: query
          name: id
          schema:
            type: integer
          description: >-
            Company ID to look up. Returns the full detail payload. Cannot be
            combined with `mode=sync`.
        - in: query
          name: mode
          schema:
            type: string
            enum:
              - sync
          description: Set to `sync` to use paginated sync mode.
        - in: query
          name: page_after
          schema:
            type: string
          description: >-
            Cursor for the next page. Pass a company ID or `start`. Only for
            `mode=sync`. Cannot be combined with `page_before`.
        - in: query
          name: page_before
          schema:
            type: string
          description: >-
            Cursor for the previous page. Pass a company ID or `end`. Only for
            `mode=sync`. Cannot be combined with `page_after`.
        - in: query
          name: page_size
          schema:
            type: integer
          description: Results per page, 1-100. Default 30. Only applies to `mode=sync`.
        - in: query
          name: sources
          schema:
            type: string
          description: >-
            Source filter for `mode=sync`. Accepts `documents`, `news`,
            `events`, `datasets`, `metrics` (including last-valuation
            projections), `filings`, `listings`, or `all`.
        - in: query
          name: updated_at_gte
          schema:
            type: string
            format: date-time
          description: >-
            ISO 8601 datetime. Required when `mode=sync`. Inclusive lower bound
            for the updated_at window.
        - in: query
          name: updated_at_lte
          schema:
            type: string
            format: date-time
          description: >-
            ISO 8601 datetime. Optional upper bound for `mode=sync` (defaults to
            now). The window must be 14 days or less.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompaniesListOrDetailResponse'
              examples:
                CompanyList:
                  value:
                    companies:
                      - id: 596
                        domain: rallyon.com
                        name: Rally
                      - id: 416
                        domain: contentful.com
                        name: Contentful
                  summary: List all companies
                  description: Returned when no query parameters are provided.
                CompanySync:
                  value:
                    companies:
                      - id: 370
                        name: Netskope
                        domain: netskope.com
                        updated_at: '2026-03-30T19:04:17.685Z'
                        updated_sources:
                          - news
                          - datasets
                      - id: 649
                        name: Anthropic
                        domain: anthropic.com
                        updated_at: '2026-03-30T19:04:17.252Z'
                        updated_sources:
                          - news
                          - datasets
                    pagination:
                      page_size: 30
                      current_page_items: 30
                      total_items: 665
                      next_link: >-
                        https://sacra.com/api/v1/companies/?mode=sync&updated_at_gte=2026-03-29T00%3A00%3A00Z&updated_at_lte=2026-03-30T19%3A04%3A17.685Z&sources=all&page_after=368
                      prev_link: null
                      after_cursor: Start
                      before_cursor: null
                  summary: Sync companies updated in a time window
                  description: >-
                    Returned when `mode=sync` is provided with an update window.
                    Intended for polling changed companies before fetching
                    downstream data.
                PrivateCompanyWithDatasets:
                  value:
                    company:
                      id: 239
                      slug: kraken
                      name: Kraken
                      domain: kraken.com
                      alternative_domains: []
                      cik: null
                      is_active: true
                      type: private
                      updated_at: '2026-02-09T20:03:19Z'
                      logo:
                        url: >-
                          https://sacra-logos.s3.us-east-2.amazonaws.com/company_logos/512.png?v=8c1f03aa
                        dimensions:
                          width: 400
                          height: 400
                      social:
                        - url: https://twitter.com/krakenfx
                          type: twitter
                        - url: https://www.linkedin.com/company/krakenfx/about/
                          type: linkedin
                      founding_year: 2011
                      legal_entities:
                        - name: Payward, Inc.
                          country: United States
                      headquarters:
                        city: San Francisco
                        country: United States
                      key_people:
                        founders:
                          - id: 869b4ca8-da2c-4bad-8f6f-9fe89e550755
                            name: Jesse Powell
                        ceo:
                          - id: 869b4ca8-da2c-4bad-8f6f-9fe89e550755
                            name: Jesse Powell
                      description: >-
                        Crypto exchange for professional traders with deep
                        liquidity and strong security infrastructure
                      categories:
                        - id: 45
                          name: crypto exchange
                          slug: crypto-exchange
                        - id: 39
                          name: crypto
                          slug: crypto
                      documents:
                        - id: 614
                          slug: david-ripley-kraken-crypto-exchanges
                          title: >-
                            David Ripley, COO of Kraken, on the future of
                            cryptocurrency exchanges
                          link: https://sacra.com/f/3qM9xK2pR7vT8nL4cYwJ6aH1uB5dZ0eQ
                          type: interview
                          date: '2022-06-13'
                          relation: subject
                          preview_meta:
                            title: >-
                              David Ripley, COO of Kraken, on the future of
                              cryptocurrency exchanges
                            image: >-
                              https://images.prismic.io/sacra/11a55ca0-161a-4019-aba4-d1cfdc5c24fd_David+Ripley.png?auto=compress,format
                            description: Sacra interview with David Ripley, COO of Kraken.
                      company_datasets:
                        - id: 0fcc2ca9-ba40-4301-95e6-807341de19dc
                          name: 'Kraken: Revenue ($M)'
                          x_label: Time
                          y_label: Revenue
                          data:
                            - x: '2022-12-31T00:00:00.000Z'
                              'y': 931200000
                              type: historical
                            - x: '2023-12-31T00:00:00.000Z'
                              'y': 657894736.84
                              type: historical
                            - x: '2024-12-31T00:00:00.000Z'
                              'y': 1500000000
                              type: historical
                          source_type: Google Sheets
                          source_url: https://docs.google.com/spreadsheets/d/example/edit
                          status: Active
                          data_type: Revenue
                          frequency: Year
                          metric: USD
                          start_date: '2022-12-31T00:00:00Z'
                          end_date: '2025-09-30T00:00:00Z'
                          created_at: '2023-09-06T15:48:50.491109Z'
                          updated_at: '2026-02-09T07:14:13.976508Z'
                          company: 239
                      financials:
                        - name: latest_estimated_revenue
                          value: 1551900000
                          date: '2025-09-30'
                        - name: latest_estimated_valuation
                          value: 20000000000
                          date: '2025-11-19'
                        - name: total_estimated_funding
                          value: 832000000
                          date: '2025-11-19'
                      listings: []
                      milestones: []
                  summary: Private company with datasets
                  description: Returned for a private company with revenue data.
                PublicCompanyWithListings:
                  value:
                    company:
                      id: 760
                      slug: coreweave
                      name: CoreWeave
                      domain: coreweave.com
                      alternative_domains: []
                      cik: null
                      is_active: true
                      type: public
                      updated_at: '2025-06-27T06:13:50Z'
                      logo:
                        url: >-
                          https://sacra-logos.s3.us-east-2.amazonaws.com/company_logos/1873.png?v=2b9e441c
                        dimensions:
                          width: 400
                          height: 400
                      social:
                        - url: https://twitter.com/CoreWeave/
                          type: twitter
                        - url: https://www.linkedin.com/company/coreweave/
                          type: linkedin
                      founding_year: 2017
                      legal_entities:
                        - name: CoreWeave, Inc.
                          country: United States
                      headquarters:
                        city: Roseland
                        country: United States
                      key_people:
                        founders:
                          - id: 3010d48c-0d75-4f11-bcde-a0a8c276280e
                            name: Michael Intrator
                        ceo:
                          - id: 3010d48c-0d75-4f11-bcde-a0a8c276280e
                            name: Michael Intrator
                      description: >-
                        Cloud GPU provider offering production-grade compute
                        infrastructure for AI model training and deployment
                      categories:
                        - id: 87
                          name: ai
                          slug: ai
                      documents: []
                      company_datasets: []
                      financials:
                        - name: latest_estimated_revenue
                          value: 1900000000
                          date: '2024-12-31'
                        - name: latest_estimated_valuation
                          value: 23000000000
                          date: '2024-12-01'
                        - name: total_estimated_funding
                          value: 3500000000
                          date: '2024-12-01'
                      listings:
                        - id: c6ad2d4b-a493-4389-bde6-94b3a136f780
                          type: public_exchange
                          venue: nasdaq
                          ticker: crwv
                          listed_at: '2025-03-28T00:00:00Z'
                          delisted_at: null
                      milestones:
                        - id: 29f65baa-8bc1-48cb-9032-ef39195ba9db
                          type: ipo
                          date: '2025-03-28T00:00:00Z'
                          label: CoreWeave's Initial Public Offering
                          description: >-
                            CoreWeave went public on the Nasdaq Global Select
                            Market under the ticker symbol 'CRWV.'
                  summary: Public company with listings and milestones
                  description: >-
                    Returned for a publicly listed company. Note the populated
                    `listings` and `milestones` arrays.
                CompanyWithoutDatasets:
                  value:
                    company:
                      id: 515
                      slug: prequel
                      name: Prequel
                      domain: prequel.co
                      alternative_domains: []
                      cik: null
                      is_active: true
                      type: private
                      updated_at: '2026-01-20T00:00:00Z'
                      logo:
                        url: >-
                          https://sacra-logos.s3.us-east-2.amazonaws.com/company_logos/2041.png?v=f57a90d3
                        dimensions:
                          width: 400
                          height: 400
                      social:
                        - url: https://twitter.com/prequel_co/
                          type: twitter
                      founding_year: 2020
                      legal_entities:
                        - name: Vigo Engineering Inc.
                          country: United States
                      headquarters:
                        city: New York
                        country: Canada
                      key_people:
                        founders:
                          - id: 4b4979f8-7175-4984-98ce-1b63f32c0a91
                            name: Charles Chretien
                          - id: 71390ec7-73ab-4eb4-a7dc-3474595479ef
                            name: Conor McCarter
                        ceo:
                          - id: 71390ec7-73ab-4eb4-a7dc-3474595479ef
                            name: Conor McCarter
                      description: >-
                        Tool for SaaS vendors to build native data warehouse
                        connectors for their customers
                      categories:
                        - id: 4
                          name: modern data stack
                          slug: modern-data-stack
                      documents: []
                      company_datasets: []
                      financials:
                        - name: total_estimated_funding
                          value: 3300000
                          date: '2024-12-16'
                      listings: []
                      milestones: []
                  summary: Company without datasets
                  description: >-
                    Some companies have no revenue or valuation datasets.
                    `company_datasets` will be an empty array.
          description: >-
            A flat company list, one full company detail payload, or a sync-mode
            paginated list depending on parameters.
        '400':
          content:
            text/plain:
              schema:
                type: string
                example: updated_at_gte cannot be greater than updated_at_lte
          description: Invalid parameter format.
        '404':
          content:
            text/plain:
              schema:
                type: string
                example: Company id not found for page_after=123
          description: Company or cursor target not found.
      security:
        - SacraAPIAuthentication: []
components:
  schemas:
    CompaniesListOrDetailResponse:
      oneOf:
        - $ref: '#/components/schemas/CompaniesListResponse'
        - $ref: '#/components/schemas/CompanyDetailResponse'
    CompaniesListResponse:
      type: object
      properties:
        pagination:
          $ref: '#/components/schemas/CompanySyncPagination'
        companies:
          type: array
          items:
            $ref: '#/components/schemas/CompanyListItem'
          description: Returned in list mode and sync mode.
      required:
        - companies
    CompanyDetailResponse:
      type: object
      properties:
        company:
          $ref: '#/components/schemas/CompanyDetail'
      required:
        - company
    CompanySyncPagination:
      type: object
      properties:
        page_size:
          type: integer
        current_page_items:
          type: integer
        total_items:
          type: integer
        next_link:
          type: string
          format: uri
          nullable: true
        prev_link:
          type: string
          format: uri
          nullable: true
        after_cursor:
          type: string
          nullable: true
        before_cursor:
          type: string
          nullable: true
      required:
        - after_cursor
        - before_cursor
        - current_page_items
        - next_link
        - page_size
        - prev_link
        - total_items
    CompanyListItem:
      type: object
      properties:
        id:
          type: integer
        domain:
          type: string
        name:
          type: string
        updated_at:
          type: string
          format: date-time
          nullable: true
        updated_sources:
          type: array
          items:
            type: string
          description: >-
            Present in `mode=sync` responses. Lists which public source groups
            changed within the requested window.
      required:
        - domain
        - id
        - name
    CompanyDetail:
      type: object
      properties:
        id:
          type: integer
        slug:
          type: string
          description: URL-safe identifier for the company.
        name:
          type: string
        domain:
          type: string
        alternative_domains:
          type: array
          items:
            type: string
          description: >-
            Additional domains that can identify or match this company while
            preserving the primary domain.
        cik:
          type: string
          nullable: true
          description: SEC Central Index Key, if applicable.
        is_active:
          type: boolean
        type:
          type: string
          description: Either `private` or `public`.
        updated_at:
          type: string
          format: date-time
          nullable: true
        logo:
          $ref: '#/components/schemas/CompanyLogo'
        social:
          type: array
          items:
            $ref: '#/components/schemas/CompanySocialLink'
        founding_year:
          type: integer
          nullable: true
        legal_entities:
          type: array
          items:
            $ref: '#/components/schemas/CompanyLegalEntity'
        headquarters:
          $ref: '#/components/schemas/CompanyHeadquarters'
        key_people:
          $ref: '#/components/schemas/CompanyKeyPeople'
        description:
          type: string
          nullable: true
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CompanyCategoryRef'
        documents:
          type: array
          items:
            $ref: '#/components/schemas/CompanyDocumentRef'
        company_datasets:
          type: array
          items:
            $ref: '#/components/schemas/CompanyDataset'
          description: >-
            Time-series datasets for revenue, growth, valuation, etc. Empty
            array if no datasets exist.
        financials:
          type: array
          items:
            $ref: '#/components/schemas/CompanyFinancial'
        listings:
          type: array
          items:
            $ref: '#/components/schemas/CompanyListing'
        milestones:
          type: array
          items:
            $ref: '#/components/schemas/CompanyMilestoneItem'
      required:
        - alternative_domains
        - categories
        - cik
        - company_datasets
        - description
        - documents
        - domain
        - financials
        - founding_year
        - headquarters
        - id
        - is_active
        - key_people
        - legal_entities
        - listings
        - logo
        - milestones
        - name
        - slug
        - social
        - type
        - updated_at
    CompanyLogo:
      type: object
      properties:
        url:
          type: string
          format: uri
        dimensions:
          $ref: '#/components/schemas/CompanyLogoDimensions'
      required:
        - dimensions
        - url
    CompanySocialLink:
      type: object
      properties:
        url:
          type: string
          format: uri
        type:
          type: string
          description: e.g. `twitter`, `linkedin`, `facebook`.
      required:
        - type
        - url
    CompanyLegalEntity:
      type: object
      properties:
        name:
          type: string
        country:
          type: string
      required:
        - country
        - name
    CompanyHeadquarters:
      type: object
      properties:
        city:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
      required:
        - city
        - country
    CompanyKeyPeople:
      type: object
      properties:
        founders:
          type: array
          items:
            $ref: '#/components/schemas/CompanyPersonFounder'
        ceo:
          type: array
          items:
            $ref: '#/components/schemas/CompanyPersonCEO'
    CompanyCategoryRef:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        slug:
          type: string
      required:
        - id
        - name
        - slug
    CompanyDocumentRef:
      type: object
      properties:
        id:
          type: integer
        slug:
          type: string
        title:
          type: string
        link:
          type: string
          format: uri
        type:
          type: string
          description: e.g. `company`, `market`, `interview`.
        date:
          type: string
        relation:
          type: string
          description: Either `subject` or `connected`.
        preview_meta:
          $ref: '#/components/schemas/DocumentPreviewMeta'
      required:
        - date
        - id
        - link
        - preview_meta
        - relation
        - slug
        - title
        - type
    CompanyDataset:
      type: object
      properties:
        id:
          type: string
          description: UUID of the dataset.
        name:
          type: string
        x_label:
          type: string
        y_label:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/DatasetDataPoint'
        source_type:
          type: string
        source_url:
          type: string
          format: uri
          nullable: true
        status:
          type: string
        data_type:
          type: string
          description: e.g. `Revenue`, `Revenue Growth Rate`, `Valuation`, `Issue Price`.
        frequency:
          type: string
          description: e.g. `Year`, `Month`, `Quarter`.
        metric:
          type: string
          description: e.g. `USD`, `Percent`.
        start_date:
          type: string
          format: date-time
        end_date:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        company:
          type: integer
          description: Company ID this dataset belongs to.
      required:
        - company
        - created_at
        - data
        - data_type
        - end_date
        - frequency
        - id
        - metric
        - name
        - source_type
        - source_url
        - start_date
        - status
        - updated_at
        - x_label
        - y_label
    CompanyFinancial:
      type: object
      properties:
        name:
          type: string
          description: >-
            One of `latest_estimated_revenue`, `latest_estimated_valuation`,
            `total_estimated_funding`.
        value:
          type: number
          format: double
          nullable: true
        date:
          type: string
          nullable: true
      required:
        - date
        - name
        - value
    CompanyListing:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          description: e.g. `public_exchange`.
        venue:
          type: string
          nullable: true
          description: e.g. `nasdaq`, `nyse`.
        ticker:
          type: string
          nullable: true
        listed_at:
          type: string
          format: date-time
          nullable: true
        delisted_at:
          type: string
          format: date-time
          nullable: true
      required:
        - delisted_at
        - id
        - listed_at
        - ticker
        - type
        - venue
    CompanyMilestoneItem:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          description: e.g. `ipo`, `funding`.
        date:
          type: string
          format: date-time
          nullable: true
        label:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
      required:
        - date
        - description
        - id
        - label
        - type
    CompanyLogoDimensions:
      type: object
      properties:
        width:
          type: integer
        height:
          type: integer
      required:
        - height
        - width
    CompanyPersonFounder:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    CompanyPersonCEO:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
    DocumentPreviewMeta:
      type: object
      properties:
        title:
          type: string
        image:
          type: string
          format: uri
          nullable: true
        description:
          type: string
          nullable: true
      required:
        - description
        - image
        - title
    DatasetDataPoint:
      type: object
      properties:
        x:
          type: string
          description: ISO 8601 datetime string.
        'y':
          type: number
          format: double
        type:
          type: string
          description: Either `historical` or `projection`.
        meta:
          type: object
          additionalProperties: {}
          nullable: true
          description: Optional metadata. Shape varies by dataset type.
      required:
        - type
        - x
        - 'y'
  securitySchemes:
    SacraAPIAuthentication:
      type: apiKey
      in: header
      name: Authorization
      description: |-
        Authenticate using one of two formats:

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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.