# getPatent

**Identifier:** `lens_getPatent`

**Provider:** [Lens](https://kirha.com/providers/lens.md)

Retrieve the full detailed record for a single patent by its Lens ID. Returns title, abstract, claims, description, inventors, applicants, owners, classifications, legal status, family info, and citations, including the scholarly works it cites (usable with getScholarlyWork). Use searchPatents first to find Lens IDs.

## Run it with the CLI

```bash
kirha tools run lens_getPatent \
  --input '{
    "lensId": "145-564-229-856-440"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "lens_getPatent",
  "input": {
    "lensId": "145-564-229-856-440"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lensId": {
      "description": "From searchPatents, e.g., 145-564-229-856-440",
      "type": "string"
    }
  },
  "required": [
    "lensId"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "abstract": {
      "type": "string"
    },
    "agents": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "anticipatedTermDate": {
      "type": "string"
    },
    "applicants": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "backwardCitationLensIds": {
      "description": "Lens IDs of backward cited patents for composition",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "backwardCitations": {
      "description": "First 50; use getPatentCitations for all",
      "items": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "type": "string"
          },
          "docNumber": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          },
          "phase": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "backwardNplCitationCount": {
      "type": "number"
    },
    "backwardPatentCitationCount": {
      "type": "number"
    },
    "citedScholarlyLensIds": {
      "description": "Scholarly Lens IDs of cited non-patent literature, for getScholarlyWork or searchScholarlyWorks (lensIds)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "claims": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "classificationsCpc": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "position": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "symbol"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "classificationsIpc": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "position": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "symbol"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "datePublished": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "discontinuationDate": {
      "type": "string"
    },
    "docNumber": {
      "type": "string"
    },
    "extendedFamilyLensIds": {
      "description": "Lens IDs of extended family members for composition",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "extendedFamilyMembers": {
      "description": "First 50; use getPatentFamily for all",
      "items": {
        "additionalProperties": false,
        "properties": {
          "docNumber": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "extendedFamilySize": {
      "type": "number"
    },
    "forwardCitationCount": {
      "type": "number"
    },
    "grantDate": {
      "type": "string"
    },
    "granted": {
      "type": "boolean"
    },
    "hasDisclaimer": {
      "type": "boolean"
    },
    "inventors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "jurisdiction": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "legalStatus": {
      "type": "string"
    },
    "lensId": {
      "type": "string"
    },
    "owners": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "publicationType": {
      "type": "string"
    },
    "simpleFamilyLensIds": {
      "description": "Lens IDs of simple family members for composition",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "simpleFamilyMembers": {
      "description": "First 50; use getPatentFamily for all",
      "items": {
        "additionalProperties": false,
        "properties": {
          "docNumber": {
            "type": "string"
          },
          "jurisdiction": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "lensId": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "simpleFamilySize": {
      "type": "number"
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "context",
    "lensId",
    "applicants",
    "inventors",
    "owners",
    "agents"
  ],
  "type": "object"
}
```

## Related tools

Other Lens tools that this tool refers to, or that refer to it.

- [`searchPatents`](https://kirha.com/providers/lens/searchPatents.md)
- [`getPatentCitations`](https://kirha.com/providers/lens/getPatentCitations.md)
- [`getPatentFamily`](https://kirha.com/providers/lens/getPatentFamily.md)
- [`getScholarlyWork`](https://kirha.com/providers/lens/getScholarlyWork.md)
- [`searchScholarlyWorks`](https://kirha.com/providers/lens/searchScholarlyWorks.md)
- [`getScholarlyCitations`](https://kirha.com/providers/lens/getScholarlyCitations.md)

-----

[All Lens tools](https://kirha.com/providers/lens.md) · [< Back to tools list](https://kirha.com/tools.md)