> ## 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. # List and search patent families > US patent families from USPTO data, one row per family (a root application with its continuations, divisionals and provisionals). Every filter is optional and filters combine with AND. `company_id` matches families whose live members are owned by that company, as recorded in USPTO assignments. About a quarter of families map to a company, so no rows for a company does not mean it holds no patents. A lapsed family has no live owners, so `company_id` with `state=lapsed` returns nothing. ## OpenAPI ````yaml /openapi.json get /v1/patents openapi: 3.1.0 info: title: Pav Enterprise API description: >- Read-only `/v1` API over Pav's biopharma dataset: drug programs, companies, clinical trials, deals, patent families, FDA records, a change feed, and dataset stats. Authenticate every request with a Pav API key as a bearer token: `Authorization: Bearer `. Mint a key in [Pav developer settings](https://app.pav.bio/settings/developer). All endpoints are `GET` and return JSON. List endpoints return a `{ data, pagination }` envelope. Pass `q=` to run relevance-ranked search that matches meaning as well as exact words; omit it for a filtered, paginated listing. Errors return `{ error: { code, message, request_id } }`. version: 1.2.0 servers: - url: https://api.pav.bio description: Production - url: / description: This server security: [] tags: - name: programs description: >- Search and filter drug pipeline assets by company, indication, target, modality, phase, or free text. Includes get-by-id, similar-programs, and facet autocomplete. - name: companies description: >- Tracked biopharma companies and their pipeline ownership. List a company's programs and change history. - name: trials description: >- Search clinical trials — ClinicalTrials.gov records plus Pav program/company links. Relevance-ranked search when `q=` is set; filtered browse otherwise. - name: deals description: >- Biopharma deals (M&A, licensing, collaborations, options, joint ventures) from SEC filings and press releases, with lifecycle state, headline economics, and source documents. - name: patents description: >- US patent families from USPTO with owners linked to Pav companies, member applications, ownership history, and statutory term. - name: fda description: >- FDA records with applicants linked to Pav companies: Orange Book products, patents and exclusivities, Purple Book biologics, orphan designations, warning letters, and recalls. - name: changes description: >- Detected pipeline movement events per company — added and removed assets and phase changes — with before/after phase and detection time. - name: stats description: High-level dataset counts and facet coverage. paths: /v1/patents: get: tags: - patents summary: List and search patent families description: >- US patent families from USPTO data, one row per family (a root application with its continuations, divisionals and provisionals). Every filter is optional and filters combine with AND. `company_id` matches families whose live members are owned by that company, as recorded in USPTO assignments. About a quarter of families map to a company, so no rows for a company does not mean it holds no patents. A lapsed family has no live owners, so `company_id` with `state=lapsed` returns nothing. operationId: list_patents parameters: - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Substring of the title, an owner name, or a member's patent number. examples: - GLP-1 title: Q description: Substring of the title, an owner name, or a member's patent number. - name: company_id in: query required: false schema: anyOf: - type: array items: type: integer - type: 'null' description: Families owned by any of these Pav company ids. Repeatable. title: Company Id description: Families owned by any of these Pav company ids. Repeatable. - name: cpc in: query required: false schema: anyOf: - type: string maxLength: 16 - type: 'null' description: CPC classification prefix on any member, e.g. `A61K` or `C07K`. examples: - A61K title: Cpc description: CPC classification prefix on any member, e.g. `A61K` or `C07K`. - name: state in: query required: false schema: anyOf: - enum: - live - lapsed type: string - type: 'null' description: '`live` (a member pending or in force) or `lapsed` (none).' title: State description: '`live` (a member pending or in force) or `lapsed` (none).' - name: granted in: query required: false schema: anyOf: - type: boolean - type: 'null' description: '`true`: at least one granted patent; `false`: none granted.' title: Granted description: '`true`: at least one granted patent; `false`: none granted.' - name: priority_from in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Earliest priority date on or after (inclusive). title: Priority From description: Earliest priority date on or after (inclusive). - name: priority_to in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: Earliest priority date on or before (inclusive). title: Priority To description: Earliest priority date on or before (inclusive). - name: include_members in: query required: false schema: type: boolean description: Include up to 30 member applications per family. default: false title: Include Members description: Include up to 30 member applications per family. - name: sort in: query required: false schema: enum: - latest_status_date - earliest_priority_date - member_count type: string description: >- `latest_status_date` (default), `earliest_priority_date`, or `member_count`; newest or largest first. default: latest_status_date title: Sort description: >- `latest_status_date` (default), `earliest_priority_date`, or `member_count`; newest or largest first. - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Rows per page (1-100). default: 25 title: Limit description: Rows per page (1-100). - name: offset in: query required: false schema: type: integer maximum: 10000 minimum: 0 description: Zero-based row offset for paging. default: 0 title: Offset description: Zero-based row offset for paging. - name: include_total in: query required: false schema: type: boolean description: Compute the exact total match count. default: false title: Include Total description: Compute the exact total match count. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PatentFamilyListResponse' '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' '422': description: Invalid parameter (`validation_error`). 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: PatentFamilyListResponse: properties: data: items: $ref: '#/components/schemas/PatentFamily' type: array title: Data description: Page of patent families. pagination: $ref: '#/components/schemas/Pagination' description: Pagination metadata for this page. type: object required: - data - pagination title: PatentFamilyListResponse ErrorEnvelope: properties: error: $ref: '#/components/schemas/ErrorBody' description: Error detail. Present only on 4xx/5xx responses. required: - error title: ErrorEnvelope type: object PatentFamily: properties: family_id: type: string title: Family Id description: Pav patent family identifier. examples: - '62662313' representative_title: anyOf: - type: string - type: 'null' title: Representative Title description: Title of the family's representative member. examples: - >- GLUCAGON LIKE PEPTIDE 1 (GLP-1) FUSION PEPTIDE ... CONJUGATES AND USES THEREOF member_count: type: integer title: Member Count description: Applications in the family. examples: - 2 granted_count: type: integer title: Granted Count description: Granted members. examples: - 1 pending_count: type: integer title: Pending Count description: Pending members. examples: - 0 earliest_filing_date: anyOf: - type: string format: date - type: 'null' title: Earliest Filing Date description: Earliest member filing. earliest_priority_date: anyOf: - type: string format: date - type: 'null' title: Earliest Priority Date description: Earliest priority date. latest_grant_date: anyOf: - type: string format: date - type: 'null' title: Latest Grant Date description: Most recent grant. latest_status_date: anyOf: - type: string format: date - type: 'null' title: Latest Status Date description: Most recent status change on any member. Default sort key. has_live_member: type: boolean title: Has Live Member description: True when any member is pending or in force. owner_names: items: type: string type: array title: Owner Names description: Recorded owners of the live members. Empty for a lapsed family. owner_is_split: type: boolean title: Owner Is Split description: True when live members have different owners. companies: items: $ref: '#/components/schemas/PatentCompany' type: array title: Companies description: >- Owners linked to Pav companies. About a quarter of families map to a company, so an empty list does not mean the company holds no patents. members: anyOf: - items: $ref: '#/components/schemas/PatentFamilyMember' type: array - type: 'null' title: Members description: >- Member applications, newest filed first. Present with `include_members=true`. type: object required: - family_id - member_count - granted_count - pending_count - has_live_member - owner_is_split title: PatentFamily Pagination: properties: limit: type: integer title: Limit description: Maximum number of rows returned for this request. examples: - 100 offset: type: integer title: Offset description: Zero-based row offset applied before returning results. examples: - 0 total: anyOf: - type: integer - type: 'null' title: Total description: >- Total matching rows across all pages. Null on relevance-ranked search responses and on listings requested without `include_total`. examples: - 590355 type: object required: - limit - offset title: Pagination 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 PatentCompany: properties: company_id: type: integer title: Company Id description: Durable Pav company identifier. examples: - 137 short_name: type: string title: Short Name description: Company slug. examples: - johnson_and_johnson name: type: string title: Name description: Company display name. examples: - Johnson & Johnson type: object required: - company_id - short_name - name title: PatentCompany PatentFamilyMember: properties: application_number: type: string title: Application Number description: USPTO application number. examples: - '17076912' patent_number: anyOf: - type: string - type: 'null' title: Patent Number description: Granted patent number; null until granted. publication_number: anyOf: - type: string - type: 'null' title: Publication Number description: Pre-grant publication number. role: type: string title: Role description: Member's place in the family (root, continuation, ...). title: anyOf: - type: string - type: 'null' title: Title description: Application title. application_type: anyOf: - type: string - type: 'null' title: Application Type description: USPTO application type. filing_date: anyOf: - type: string format: date - type: 'null' title: Filing Date description: Filing date. grant_date: anyOf: - type: string format: date - type: 'null' title: Grant Date description: Grant date. status_description: anyOf: - type: string - type: 'null' title: Status Description description: Current USPTO status. status_date: anyOf: - type: string format: date - type: 'null' title: Status Date description: Date of the current status. is_dead: type: boolean title: Is Dead description: True when the application is abandoned or expired. cpc_codes: items: type: string type: array title: Cpc Codes description: CPC classification codes. type: object required: - application_number - role - is_dead title: PatentFamilyMember 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 ````