Check Listing Status

API reference for /api/v2/listing/status/{transactionId}

The listing/status endpoint allows you to track the progress of asynchronous operations triggered by the V2 endpoints (/api/v2/listing/vehicle and /api/v2/listing/images).

The V2 endpoints return a 202 Accepted along with a transactionId in the response payload. You can use this ID to poll for the current status.

Status Values

The status field in the response returns one of the following values:

Status	Meaning
Accepted	The transaction has been successfully received and placed in the queue. Processing has not yet started.
Processing	The transaction is actively being worked on by the background processor.
Succeeded	The transaction completed successfully, and the listing/images are now live.
Failed	The transaction encountered an error and could not be completed. Check the errorMessage field for details.

Example Request

GET /api/v2/listing/status/3fa85f64-5717-4562-b3fc-2c963f66afa6
Authorization: Bearer eyJh...usDM

Example Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stockNumber": "C2026",
  "listingId": 1234567,
  "branch": "Christchurch",
  "status": "Succeeded",
  "errorMessage": null,
  "createdDateUtc": "2026-04-14T05:22:00Z",
  "modifiedDateUtc": "2026-04-14T05:23:00Z"
}