ImportOS · Docs
API reference

GET /v1/extension/requests

Open client requests to attach a lot to

Open client requests to attach a lot to

Requests in status new, searching or offered (newest first), with the client name and a one-line summary of what the client wants. Requires scope write:deals.

  • Authentication: header Authorization: Bearer rv_live_... (API keys and scopes)
  • Required scope: write:deals
Descriptions of the operation, parameters and fields come from the OpenAPI specification (openapi.json).

Parameters

FieldInTypeRequiredDescription
qquerystringnoSearch by client name, make or model.
limitqueryintegerno

Responses

200

Open requests.

application/json · Schema: OpenRequestsResponse

FieldTypeRequiredDescription
itemsobject[]yes
items[].idstring (uuid)no
items[].contact_namestring | nullno
items[].summarystringnoWhat the client wants, e.g. "Toyota Camry 2018-2020, up to 20000 USD".
items[].statusstringno
items[].destination_countrystring | nullno
items[].destination_citystring | nullno
items[].created_atstringno

400

Invalid request parameters or body (code validation_error).

application/problem+json · Schema: Problem

401

Missing, malformed, unknown, revoked or expired API key (code unauthorized).

application/problem+json · Schema: Problem

403

The API key lacks the scope required by this endpoint (code insufficient_scope).

application/problem+json · Schema: Problem

429

Rate limit exceeded for the tenant plan (code rate_limited). Wait Retry-After seconds.

application/problem+json · Schema: Problem

On this page