> ## Documentation Index > Fetch the complete documentation index at: https://docs.pav.bio/llms.txt > Use this file to discover all available pages before exploring further. # Get a company > One company with its tickers, owner and website. ## OpenAPI ````yaml /openapi.json get /v1/companies/{company_id} openapi: 3.1.0 info: title: Pav Enterprise API description: >- Read-only API over Pav's biopharma data: programs, drugs, companies, trials, deals, patents, FDA records and changes. Send `Authorization: Bearer `. Lists return `{data, next_cursor, total}`; errors return `{error: {code, message, request_id}}`. Parameter rules: [Conventions](https://docs.pav.bio/conventions). version: 2.0.0 servers: - url: https://api.pav.bio description: Production security: [] tags: - name: search description: Find the id of a company, drug, program, target or indication. x-group: Search - name: programs description: 'Drug programs: one drug in one indication at one company.' x-group: Programs - name: drugs description: >- One drug product across every company that develops it, under all its names, with its programs. x-group: Drugs - name: companies description: Biopharma companies, their owners and their trials. x-group: Companies - name: trials description: ClinicalTrials.gov trials linked to programs and companies. x-group: Trials - name: deals description: M&A, licensing and collaboration deals with terms and sources. x-group: Deals - name: patents description: US patent families with owners, members and term. x-group: Patents - name: fda description: FDA records, one endpoint per record type. x-group: FDA - name: changes description: Program and trial changes, newest first. x-group: Changes - name: stats description: Dataset counts. x-group: Stats paths: /v1/companies/{company_id}: get: tags: - companies summary: Get a company description: One company with its tickers, owner and website. operationId: get_company parameters: - name: company_id in: path required: true schema: type: integer description: Company id. examples: - 412 title: Company Id description: Company id. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Company' '400': description: Invalid parameter (`validation_error`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Missing or invalid API key (`unauthorized`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Unknown id or route (`not_found`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limit exceeded (`rate_limited`); honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' security: - EnterpriseApiKey: [] components: schemas: Company: properties: company_id: type: integer title: Company Id description: Durable Pav company identifier. examples: - 412 short_name: type: string title: Short Name description: Company slug, a stable readable identifier. examples: - pfizer name: type: string title: Name description: Company display name. examples: - Pfizer country: anyOf: - type: string - type: 'null' title: Country description: Headquarters country, when known. examples: - United States asset_count: type: integer title: Asset Count description: Number of pipeline programs Pav tracks for this company. default: 0 examples: - 87 last_checked_at: anyOf: - type: string format: date-time - type: 'null' title: Last Checked At description: When Pav last read this company's pipeline (UTC). examples: - '2026-06-19T04:12:00Z' parent_company_id: anyOf: - type: integer - type: 'null' title: Parent Company Id description: Id of the company that owns this one, when known. examples: - 137 parent_company_name: anyOf: - type: string - type: 'null' title: Parent Company Name description: Display name of the owning company. examples: - Johnson & Johnson acquired_by: anyOf: - $ref: '#/components/schemas/CompanyAcquisition' - type: 'null' description: 'Set when this company was bought: the buyer and the completion date.' tickers: items: $ref: '#/components/schemas/CompanyTicker' type: array title: Tickers description: >- Current stock tickers, with the exchange when known. Empty when private. cik: anyOf: - type: string - type: 'null' title: Cik description: >- SEC Central Index Key, 10 digits, when the company files with the SEC. examples: - '0000200406' website: anyOf: - type: string - type: 'null' title: Website description: Company website, when known. examples: - https://www.pfizer.com type: object required: - company_id - short_name - name title: Company ErrorEnvelope: properties: error: $ref: '#/components/schemas/ErrorBody' description: Error detail. Present only on 4xx/5xx responses. required: - error title: ErrorEnvelope type: object CompanyAcquisition: properties: company_id: type: integer title: Company Id description: Pav id of the buyer. examples: - 137 name: type: string title: Name description: Buyer display name. examples: - Johnson & Johnson completed_on: anyOf: - type: string format: date - type: 'null' title: Completed On description: Date the acquisition completed, when known. examples: - '2017-06-16' type: object required: - company_id - name title: CompanyAcquisition CompanyTicker: properties: ticker: type: string title: Ticker description: Ticker symbol. examples: - JNJ exchange: anyOf: - type: string - type: 'null' title: Exchange description: Listing exchange, when known. examples: - NYSE type: object required: - ticker title: CompanyTicker ErrorBody: properties: code: description: >- Stable, machine-readable error code (e.g. `unauthorized`, `not_found`, `validation_error`, `error`). examples: - not_found title: Code type: string message: description: Human-readable explanation of the error. examples: - program 999999 not found title: Message type: string request_id: anyOf: - type: string - type: 'null' default: null description: >- Correlation id echoed in the `X-Request-ID` response header. Quote it when contacting Pav support about a failed request. examples: - 3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d title: Request Id required: - code - message title: ErrorBody type: object securitySchemes: EnterpriseApiKey: type: http description: >- Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer . scheme: bearer bearerFormat: Pav API key ````