Skip to main content
The Novatrade24 Integration API lets marketplaces, dealers, and financial partners embed EU VAT-compliant cross-border vehicle transactions into their own systems. Every integration flows through the same end-to-end compliance workflow, from buyer onboarding to a closed order with every artifact on file.
Status: Draft specification. The production endpoint https://api.novatrade24.com/v1 is live, with access restricted to pilot customers. A hosted mock server is available at https://mock.api.novatrade24.com for integration design.

​
What the API does

  • Upsert a buyer and carry a KYC workflow to completion (marketplace-led or NT24-led).
  • Register a VIN-based order linked to that buyer, with invoice, payment, and transport sub-resources.
  • Poll a single compliance rollup or subscribe to webhooks to know when a transaction is ready for pickup, closed, or blocked.
  • See exactly what is missing: the rollup’s blockers[] names the artifact and the module waiting for it.

​
Workflow at a glance

1

Create or sync the buyer

POST /partners/{sellerId}/buyers upserts by VAT number. Choose NT24_LED (NT24 runs full verification + iDenfy + AML); MARKETPLACE_LED (you provide KYC data) is not available yet.
2

Register the order

POST /partners/{sellerId}/orders with the VIN(s) and buyer reference.
3

Submit invoice, payment, transport

Three sub-resources on the order. Upload required documents as you go.
4

Poll compliance or wait for webhook

GET /partners/{sellerId}/orders/{uuid}/compliance or subscribe to compliance.status_changed. blockers[] tells you what is still missing.
5

Clear the blockers

Each blocker carries a code, and a documentType when a document is what is missing. NT24 staff close the order once everything is on file, and the rollup reports complianceStatus: VALID.

​
How the API is organized

Buyer / KYC

Create buyers, upload KYC documents, trigger VIES checks and NT24-led verification.

Orders

Register VIN-based transactions and track their compliance state.

Invoice, Payment, Transport

Submit commercial data and supporting documents.

Compliance rollup

One call for all five module states, plus what is still missing.

Webhooks

Subscribe to compliance transitions, VIES failures, prospect submissions.

Security & Compliance

OAuth2 service accounts, DPA, GDPR, EU-only data residency.

​
Who this is for

  • Marketplaces onboarding buyers on behalf of many dealer sellers.
  • Dealer groups integrating their DMS to NT24 for their own sales pipeline.
  • Dealer Management System (DMS) vendors offering NT24 compliance as a feature.
  • Direct dealers automating workflows they already perform manually in the NT24 web app.

​
Next steps

Quickstart

Get a token and call /me in 5 minutes.

API Reference

Every endpoint, schema, and example.

Contact

Request pilot access.