---
title: "P037 Legal Indicators"
method: GET
path: "/patent-valuation-data/legal_indicators"
tags: ["Patent Valuation Data"]
---

# P037 Legal Indicators

`GET /patent-valuation-data/legal_indicators`

## Request

- Base URL: `https://connect.patsnap.com`
- URL: `https://connect.patsnap.com/patent-valuation-data/legal_indicators`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/docs/patent-valuation-data/legal_indicators/get.ts> (a function with typed inputs; its response is checked against the schema)

Receive patent legal valuation score data by patent_id or patent_number. This includes litigation Authority, litigation count, re-examination or invalidation activity, legal status, patent age, remaining life of the patent, and pending time.

## Query parameters

- `patent_id` string: patent_id
- `patent_number` string: patent_number

## Response `200`

Successful p037 legal indicators response.

- P037PatentValuationDataLegalIndicatorsResponse
  - `data` P037PatentValuationDataLegalIndicatorsPatentLegalValueResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patsnap_legal_value` P037PatentValuationDataLegalIndicatorsLegalValue
      - `granted_no` integer: Family granted patent count
      - `legal_status` string: Patent legal status:<p>Published, Examining, Granted, Abandoned, Withdrawn, Expired, Non-Payment, Ceased</p>
      - `litigation_no` integer: Litigation count
      - `patent_age_day` integer: Patent age
      - `invalid_fail_no` integer: Number of invalid failures
      - `grant_waiting_day` integer: Patent pending time
      - `has_reexam_invalid` string: Whether has re-examination or invalidation activity
      - `invalid_success_no` integer: Number of invalid successes
      - `litigation_country` unknown[]: Litigation Authority
        - unknown
      - `in_application_ratio` number, double: Ratio of patents at the application stage in the simple family
      - `remaining_time_ratio` number, double: Patent remaining time ratio
      - `avg_originality_index` number, double: Tech Original Index
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found.

---

[API](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api.md) - [All operations](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/revisions/c2264a0de595?raw)