Skip to main content
GET
List your searches

Authorizations

Authorization
string
header
required

An API key created in the PartFinder console at https://console.partfinder.dev, or a customer key created with POST /v1/keys. Send as Authorization: Bearer <key>. Revocation takes effect within approximately one minute.

Query Parameters

limit
integer
default:50

Searches per page, 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page, unchanged. Omit it for the first page.

Response

The list.

as_of
string<date-time>
required

ISO 8601. How current the data in this response is.

summary
string
required

Plain language an agent can relay without re-deriving it.

notice
string
required

Informational-use notice. Always present.

searches
object[]
required

One page, newest first. Read one with GET /v1/search/{id} for its rows.

next_cursor
string | null
required

Pass as cursor to get the next page. Null when this page is the last.