Skip to main content
GET
/
partners
/
{sellerId}
/
orders
List orders.
curl --request GET \
  --url https://api.novatrade24.com/v1/partners/{sellerId}/orders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "externalOrderId": "<string>",
      "buyerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "CREATED",
      "vins": [
        {
          "vin": "<string>",
          "brand": "<string>",
          "model": "<string>",
          "purchaseAmount": {
            "value": 7900,
            "currency": "EUR"
          },
          "mileage": 1,
          "firstRegistrationDate": "2023-12-25",
          "complianceStatus": "PENDING"
        }
      ],
      "totalAmount": {
        "value": 7900,
        "currency": "EUR"
      },
      "version": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "purchaseDate": "2023-12-25",
      "responsibleContact": {
        "firstName": "<string>",
        "lastName": "<string>",
        "email": "[email protected]",
        "phone": "<string>"
      }
    }
  ],
  "pagination": {
    "page": 123,
    "size": 123,
    "totalElements": 123,
    "totalPages": 123,
    "hasNext": true,
    "hasPrevious": true
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0 client_credentials grant via Keycloak service account. Clients are provisioned per IntegrationOrganization in the nt24-idp realm.

Path Parameters

sellerId
string<uuid>
required

UUID of the seller trade partner (must be in caller's authorized list).

Query Parameters

status
string
createdAfter
string<date-time>
updatedAfter
string<date-time>
buyerId
string<uuid>
vin
string

Filter by VIN. VIN is not globally unique — same VIN may appear in multiple historical orders across time.

Required string length: 17
page
integer
default:0
Required range: x >= 0
size
integer
default:20
Required range: 1 <= x <= 100
sort
string

field,direction — e.g. createdAt,desc.

Response

OK

data
object[]
required
pagination
object
required