---
title: "D101 life cycle data"
method: POST
path: "/shhgy/reportdata/life-cycle"
tags: ["Custom Aggregate Data"]
---

# D101 life cycle data

`POST /shhgy/reportdata/life-cycle`

## Request

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

This interface is a statistical analysis interface that provides the number of patent applications per year over the past 10 years, as well as the number of invention patent applications.

## Request body

- D101ReportdataLifeCycleRequest
  - `collapse_order` string: Select the patent collapse ordering rule that is valid only if collapse_by is APD or PBD, setting OLDEST or LATEST to keep the earliest or latest one
  - `query_text` string, required: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
  - `sort` D101ReportdataLifeCycleLifeCycleSort[]: field order
    - `field` string: sort field
    - `order` string: asc OR desc
  - `collapse_type` string: Select the collapse type, "ALL" or Null value means no collapse; "APNO" means collapse according to application number; "DOCDB" means collapse according to simple family; "INPADOC" means collapse according to inpadoc family; "EXTEND" means collapse according to patsnap family
  - `collapse_by` string: <p>Select the sort field for patent collapse,</p><p>"APD" means order according to application date;</p><p>"PBD" means order according to publication date;</p><p>"AUTHORITY" means order according to authority;</p><p>"SCORE" means order according to the relevance score</p>
  - `collapse_order_authority` unknown[]: Sets the order of patent collapse according to the input authorities priority list, valid only if collapse_by is AUTHORITY
    - unknown

## Response `200`

Successful d101 life cycle data response.

- D101ReportdataLifeCycleResponse
  - `data` D101ReportdataLifeCycleLifeCycleResponse
    - `values` D101ReportdataLifeCycleReportData[]: values
      - `year` string: year
      - `total` integer: total num
      - `inv_total` integer: invent total num
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `201`: Created.
- `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)