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 signed export file ready for the tax authority.
Status: Draft specification. This documentation describes the Phase 1 API. No production endpoint exists yet. 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 or export.
  • Download the generated Export File — the signed PDF your customer’s tax authority expects.

​
Workflow at a glance

1

Create or sync the buyer

POST /partners/{sellerId}/buyers upserts by VAT number. Choose MARKETPLACE_LED (you provide KYC data) or NT24_LED (NT24 runs full verification + iDenfy + AML).
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.
5

Download the Export File

Auto-generated when compliance reaches VALID or INVALID. Emitted via export_file.generated webhook.

​
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 & Export File

Poll rollup state, download the final export artifact.

Webhooks

Subscribe to compliance transitions, VIES failures, export file events.

Security & Compliance

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

​
Who this is for

  • Marketplaces (Santander-style) 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.