API Documentation

Explore maintained technical reference and guides for supported DriverXtra integrations. Published access and availability may depend on your organization, market and program.

Browse the reference Request technical access

Listings (demo) · ReferenceDemonstration reference

List listings

GET/v1/listings

Returns a page of listings visible to your organization.

Version: 2026-10-01
Status: Current
Owner: Marketplace API team (demo)
Last reviewed: 1 Oct 2026

Public · Lifecycle: Stable · Environments: demonstration only

Authentication

Bearer token with scope listings:read

Parameters

Name	In	Type	Required	Description
page_cursor	query	string	Optional	Opaque cursor from a previous response.
limit	query	integer	Optional	Maximum items per page. Allowed range: not specified.
make	query	string	Optional	Filter by vehicle make.

Request body

None for this operation.

Responses

200

Property	Type	Presence	Description
items	array	Required	Listings in this page.
items[].id	string	Required	Listing identifier.
items[].title	string	Required	Display title.
items[].price	object	Nullable	Price and currency, when published.
next_cursor	string	Nullable	Cursor for the next page; absent on the last page.

Example

HTTP

Synthetic

GET /v1/listings?make=Example&limit=2
Authorization: Bearer <YOUR_APPROVED_TOKEN>

200 OK
{
  "items": [
    { "id": "lst_demo_001", "title": "2021 Example Hatchback",
      "price": { "amount": 14995, "currency": "GBP" } }
  ],
  "next_cursor": null
}

Errors

Status	Code	Meaning	Safe to retry?
400	invalid_parameter	A parameter is malformed.	No — fix the request
401	unauthorized	Credentials missing or invalid.	No
429	rate_limited	Too many requests.	Yes — with backoff
5xx	server_error	Temporary service problem.	Yes — with backoff
Other	—	Undocumented — don't assume behavior	Not specified

Pagination & retries

Pagination: Cursor-based: pass next_cursor as page_cursor. Ordering is stable within a cursor sequence.
Idempotency: Not applicable — read-only.

Limits

Rate limit: Not specified. Rate-limit details are not documented for this operation. Confirm current terms before relying on any assumed limit.
Timeout: Not specified.
Service health: View Platform Status

Compatibility & changes

2026-10-01
Added the make filter (demonstration change log)
2026-04-01
Initial version — deprecated

Did this page help you find what you needed?

Anonymous. Never include keys, tokens or personal data.

WebhooksEvent topics and signature verification.Open Webhooks

Inventory & Catalog IntegrationsFeed mappings and reconciliation.Open Inventory & Catalog Integrations

Order & Booking IntegrationsSupported transaction flows.Open Order & Booking Integrations

Security & Integration GuidanceAuth, scopes and secret handling.Open Security & Integration Guidance

FAQ

API Documentation questions

It explains approved API reference material and integration concepts, including operation definitions, required inputs, output structures, errors and applicable version information where those details have been published.

No, for pages marked Public. Partner-restricted pages need a verified organization and approved access.

No. Availability depends on your organization, market and program.

Use the Version menu in the reference sidebar. Each version shows whether it's current or deprecated.

No. Calling an operation needs approved access and the scope listed on its page.

Access requests go through the Developer Hub, where they're routed to the right owner.

No public try-it tool is offered. Approved testing uses synthetic data only.

Bearer tokens with operation-level scopes. See the Authentication guide.

Each operation's Parameters table lists where the field goes, its type, whether it's required and what it means.

Examples use synthetic data and placeholder tokens. They're for illustration — never paste real credentials into them.

In each operation's Errors section and in the Errors guide.

Where limits are documented they're shown under Limits. If a limit isn't specified, confirm current terms before relying on any assumed limit.

List operations use cursors. Retry only where the reference says it's safe, with backoff.

Webhooks have their own reference page, covering event families, signatures and delivery semantics.

It keeps working for a published period before retirement. Move to the current version before then.

Use the feedback at the end of each page, or report a problem from the Developer Hub. Don't include secrets or personal data.

Platform Status shows current and historical component status.

Only where a reference page links to them. Anything else should be treated as unofficial.