---
title: "Get Patent Documents"
method: GET
path: "/patent/search"
tags: ["patents"]
---

# Get Patent Documents

`GET /patent/search`

## Query parameters

- `token` string, required
- `query` string, required
- `size` integer
- `from` integer
- `include` string
- `exclude` string
- `sort` string

## Response `200`

Valid response from the server

- PatentApiResponse
  - `total` integer — Total number of search results exists.
  - `results` integer — Number of results in this response.
  - `data` object[] — List of Patent Documents
    - `lens_id` string
    - `jurisdiction` string
    - `doc_number` number
    - `kind` string
    - `date_published` string
    - `doc_key` string
    - `docdb_id` number
    - `lang` string
    - `biblio` object
      - `publication_reference` object
        - `jurisdiction` string
        - `doc_number` number
        - `kind` string
        - `date` string
      - `application_reference` object
        - `jurisdiction` string
        - `doc_number` number
        - `kind` string
        - `date` string
        - `application_reference` string
      - `priority_claims` object
        - `claims` object[]
          - `jurisdiction` string
          - `doc_number` number
          - `kind` string
          - `date` string
          - `sequence` integer
      - `invention_title` object
        - `text` string
        - `lang` string
      - `parties` object
        - `applicants` object
          - `residence` string
          - `extracted_name.value` string
          - `extracted_address` string
        - `inventors` object
          - `residence` string
          - `sequence` string
          - `extracted_name.value` string
          - `extracted_address` string
        - `agents` object
          - `extracted_name.value` string
          - `extracted_address` string
          - `extracted_country` string
        - `owners_all` object
          - `recorded_date` string
          - `execution_date` string
          - `extracted_name.value` string
          - `extracted_address` string
          - `extracted_country` string
      - `classifications_ipcr.classifications.symbol` string
      - `classifications_cpc.classifications.symbol` string
      - `classifications_national.classifications.symbol` string
      - `references_cited` object
        - `citations` object[]
          - `sequence` string
          - `patcit` object
            - `document_id` object
              - …
            - `patcit.lens_id` string
        - `nplcit` object
          - `text` string
          - `lens_id` string
          - `external_ids` string[]
        - `npl_resolved_count` string
        - `npl_count` string
      - `cited_by` object
        - `patents` object
          - `document_id` object
            - `jurisdiction` string
            - `doc_number` number
            - `kind` string
            - `date` string
          - `lens_id` string
    - `families` object
      - `simple_family` object
        - `members` object
          - `document_id` object
            - `jurisdiction` string
            - `doc_number` number
            - `kind` string
            - `date` string
          - `lens_id` string
      - `extended_family` object
        - `members` object
          - `document_id` object
            - `jurisdiction` string
            - `doc_number` number
            - `kind` string
            - `date` string
          - `lens_id` string
    - `legal_status` object
      - `granted` boolean
      - `grant_date` string
      - `application_expiry_date` string
      - `anticipated_term_date` string
      - `has_disclaimer` boolean
      - `patent_status` string
      - `publication_count` number
      - `has_spc` string
      - `discontinuation_date` string
      - `calculation_log` string[]
    - `abstract` object
      - `text` string
      - `lang` string
    - `claims` object
      - `claim_text` string
      - `claims` string
      - `lang` string
    - `description` object
      - `text` string
      - `lang` string
    - `publication_type` string

## Other responses

- `204` — No Content
- `400` — Malformed request or incorrect fields/values provided
- `401` — Authentication credentials might be incorrect or missing
- `404` — Incorrect Resource URL / Empty Result for supplied queries / Expired scroll_id
- `415` — Request body is not json or Content Type is not application/json
- `429` — You have exceeded the number of allowed calls

---

[API](https://skmtc.net/lens/apis/lens-api.md) · [All operations](https://skmtc.net/lens/apis/lens-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lens/lens-api/revisions/4212453c4c6a/schema)