POST
https://api.milda.ai/v1/patents/listList
application/json01
Description
Patents — Patent List
POST /v1/patents/list
Paginated list of the company's patents, with optional filters.
Request
company_id(required) — Company ID.offset(default 0),limit(default 50, max 200) — pagination.sort_order—desc(default) orasc, by filing date.family_id,publication_nr— optional exact-match filters.filing_date_from,filing_date_to— optional filing-date range (YYYY-MM-DD).granted— optional filter by grant status.
Response
rows— list of patents. Each row:title,publication_nr,family_id,family_sizeearliest_filing_datehigh_value— whether the patent is classified as high-value.citing_family_count,cited_family_countpatent_linktotal— total patents available.
Returns 204 No Content if the company has no patents.
Credits
Charged a small flat fee per page (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
PatentListRequestPatentListRequesttypereq8 fields
company_idstringyesCompany ID.
page_nointeger—Page number (25 patents per page).min 1 · default 1
sort_orderstring—Sort by filing date: 'asc' or 'desc'.default "desc"
family_idstring | null—Filter by patent family id.
publication_nrstring | null—Filter by publication number.
filing_date_fromstring | null—Earliest filing date (YYYY-MM-DD).
filing_date_tostring | null—Latest filing date (YYYY-MM-DD).
grantedboolean | null—Filter by grant status.
04
Responses
200 Successful Response422 Validation Error
PatentListResponsetypereq2 fields
+rowsPatentRow[]—The company's patents for the requested page.
titlestring | null—Patent title.
publication_nrstring | null—Patent publication number.
family_idstring | null—Patent family id.
earliest_filing_datestring | null—Earliest filing date in the family (YYYY-MM-DD).
family_sizeinteger | null—Number of patents in the family.
high_valueboolean | null—Whether the patent is classified as high-value.
citing_family_countinteger | null—Number of patent families citing this patent.
cited_family_countinteger | null—Number of patent families this patent cites.
patent_linkstring | null—Link to the patent.
totalinteger—Total number of patents available.default 0