POST
https://api.milda.ai/v1/patents/listPatent List
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.page_no(default 1) — page of results, 25 per page, up to page 400.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
tokenheaderone ofYour API token, sent as "token: YOUR_API_TOKEN". Send this or Authorization.
Authorizationheaderone ofThe same token in the standard form, sent as "Authorization: Bearer YOUR_API_TOKEN" (the word Bearer, a space, then your token). Send this or token.
03
Request body
PatentListRequestPatentListRequesttypereq8 fields
Company
company_idstringyesCompany ID.
Filters
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.
Results
sort_order"asc" | "desc"—Sort by filing date: 'asc' or 'desc'.default "desc"
page_nointeger—Page number (25 patents per page, up to 400).1–400 · default 1
04
Responses
200 Successful Response422 Validation Error
PatentListResponsetype2 fields
+rowsPatentRow[]The company's patents for the requested page.
titlestring | nullPatent title.
publication_nrstring | nullPatent publication number.
family_idstring | nullPatent family id.
earliest_filing_datestring | nullEarliest filing date in the family (YYYY-MM-DD).
family_sizeinteger | nullNumber of patents in the family.
high_valueboolean | nullWhether the patent is classified as high-value.
citing_family_countinteger | nullNumber of patent families citing this patent.
cited_family_countinteger | nullNumber of patent families this patent cites.
patent_linkstring | nullLink to the patent.
totalintegerTotal number of patents available.default 0