Send your data to UDB using REST API for any voluntary scheme

Send your data to UDB using UDB REST API. You only have to integrate with our UDB REST API and we take care of the complexity sending the data to UDB

 TRY FOR FREE

UDB REST API documentation

Our awesome clients

Send now your data in UDB

GET STARTED FOR FREE

What our users saying

“

Ademico Software helped us to configure our Domibus access point on premise for the ICS2 project, facilitating the management with the European Commission. Great work and great professionals.

Juan Miguel San Miguel de la Vega
Cacesa Tech & Logistics

“

We had issues configuring the PKI certificates in Domibus. Ademico Software solved our issue is less than one hour. What a great support!

Olivier A.
Developer

“

Ademico Software Team installed Domibus Access Point on our IT infrastructure. They performed all the configuration, including the PKI certificates and the connection with EUDAMED.

John B.
Software Architect

Ademico Software in numbers

Customers served! 0 +  Domibus Access Point
installations
Customers served! 0 + exchanged messages
Customers served! 0 +   custom API integrations

How it works

1

Onboard in UDB

We help you at each step with the UDB onboarding

2

Integrate your ERP/application with our UDB REST API

We take care of the complexity of sending your data to UDB. You only need to integrate your application with our UDB REST API

3

Register your data in UDB

Send your data in JSON format and process the registration responses from UDB.

Why working with us

  • Support included

We offer prompt support for any technical or business inquiries related to UDB.

Leveraging our extensive UDB integration experience, we can assist you at every stage. We provide a comprehensive starter kit, complete with examples and extensive documentation.

  • Notifications

UDB API streamlines the process of tracking the status of the requests sent to UDB.

You are notified when the UDB response is available, using either webhooks or polling.

  • Less complexity

Our solution mitigates the complexity of the UDB exchange model by generating the UDB XML on your behalf from a simplified JSON interface. 

The validations integrated into our UDB API help prevent the submission of incorrect requests. Additionally, it reduces the impact of changes in the UDB exchange model version.

  • Security

Our organization is ISO 27001 certified, ensuring that we handle your data with the highest standards of cybersecurity. You have the flexibility to configure the data retention policy according to your needs.

Your data is stored in the AWS Ireland region in Europe, and our infrastructure is set up in a high availability mode, ensuring a 99.9% uptime guarantee

UDB Cloud Plans

Instance 1
Free trial

€0

  • Test your integration with UDB free of charge
  • UDB Test environment
  • Data hosted in EU in AWS
  • API integration: UDB REST API
TRY FOR FREE
Professional

€5400

/year

  • 40 000 UDB requests/year. Only requests  are counted and not the responses from UDB.
  • UDB Test/Production environment
  • Data hosted in EU in AWS
  • 99.9% availability
  • API integration: UDB REST API
  • We take care of the complexity of sending your data to UDB. You only need to integrate your backend application with our UDB REST API
  • Support, maintenance and monitoring included
  • Disaster recovery plan
BUY NOW
Enterprise

Contact us

 

  • 40 000 UDB requests+ /year.  Only requests are counted and not the responses from UDB.
  • UDB Test/Production environment
  • Data hosted in EU in AWS
  • 99.9% availability
  • API integration: UDB REST API
  • We take care of the complexity of sending your data to UDB. You only need to integrate your backend application with our UDB REST API
  • Prority support, maintenance and monitoring included
  • Disaster recovery plan
  • 1-on-1 onboarding
BUY NOW

Do you have questions regarding our plan or you need a custom quotation? Contact us here.

FREQUENTLY ASKED QUESTIONS

Does your API support all UDB operations?

UDB REST API can manage all operations supported by UDB using eDelivery system to system communication.

The following operations are supported as REST endpoints:

  • Initial Stock Registration
  • Sourcing Contacts
  • Seller Transaction
  • Buyer Transaction
  • Point of Origin Buyer Trade
  • POS and Sustainability Data
  • Material Processing

UDB integration for economic operators

Put your UDB reporting on autopilot.

One REST API from your ERP to the Union Database.

Your users keep working in the ERP or application they already know. Ademico acts as the communication layer: we transform your JSON into the UDB XML exchange model, validate it, deliver it securely, and return the asynchronous result.

Start free in TEST Explore the API
✓JSON REST API ✓All Voluntary Schemes ✓Your system stays the interface
LIVE DATA ROUTE TEST → PROD
Webhook or polling notificationCorrelated by transmissionId
Your systems ERP · platform JSON
REST API→
MANAGED Ademico SaaS Validate & convert UDB XML · XSD
eDelivery→
European Commission Union Database UDB
Immediate responseQUEUED UDB outcomeSUCCESS / FAILED
NO NEW OPERATIONAL PORTALYour familiar application remains the interface
ISO/IEC
27001
AWS Ireland
EU data residency
99.9%
availability
Developer-led
support
RECOGNISED ACCESS POINT EXPERIENCEAdemico Software has been nominated by the ISCC EU voluntary scheme as an Access Point Provider.
3+ yearsworking with UDB since the project started
All Voluntary Schemessupported through one REST integration
A simpler integration boundary

Your ERP speaks JSON.
UDB expects much more.

The exchange model, schema validation, ZIP packaging, Access Point transport, status tracking, and model updates should not become another platform for your team to operate.

WITHOUT ADEMICO

Build the complete UDB route

×
  1. 01Map ERP data to the evolving UDB XML exchange model
  2. 02Validate schemas, package payloads, and handle errors
  3. 03Operate an eDelivery Access Point and its secure route
  4. 04Correlate asynchronous responses and UDB notifications
WITH ADEMICO

Integrate once with REST

✓
POST/api/udb/v1/eo-transactions
{
  "businessIdentifier": "ERP-84721",
  "referenceNumber": "REF-555",
  "materialCode": "URWC010",
  "posData": { ... }
}

200Request acceptedQUEUED ✓

Keep UDB reporting inside the application your team already uses.

From payload to registered outcome

One API call.
Every step accounted for.

UDB communication is asynchronous. Ademico gives your application a clean, traceable lifecycle from local validation to the final UDB result.

  1. 1
    Submit JSON

    Your ERP sends a UDB operation with its NTR ID and optional business identifier.

  2. 2
    Validate before delivery

    Ademico transforms JSON to UDB XML and checks it against the current XSD.

  3. 3
    Queue and send

    Your application receives a transmission ID while the managed Access Point delivers the request.

  4. 4
    Receive the UDB outcome

    Process webhook or polling notifications and correlate them to the original request.

POST/api/udb/v1/eo-transactionsapplication/json
{
  "businessIdentifier": "ERP-84721",
  "sellerEconomicOperatorNumber": "BE_...",
  "buyerEconomicOperatorNumber": "NL_...",
  "referenceNumber": "REF-555",
  "tradeDate": "2026-07-18",
  "materialCode": "URWC010",
  "transactionMaterials": [ { ... } ],
  "posData": { ... }
}

JSON is converted and XSD-validated before exchange.

OAuth2 client credentialsTEST + PRODOpenAPI 3
Full material lifecycle

One API for the UDB work your operation actually does.

From first collection to processing, trade, stock reconciliation, and final market reporting, the same integration model covers the complete system-to-system scope.

01

Collect & acquire

Register sourcing contacts and report First Gathering Point or Point of Origin trades.

  • Sourcing contacts
  • FGP transactions
  • PoO trades
02

Trade & transfer

Create, accept, reject, cancel, and update transactions between operators or sites.

  • Seller & buyer flows
  • Internal transfers
  • Back-to-back trades
03

Process & convert

Record material processing, unit conversion, PoS details, and sustainability data.

  • Material processing
  • Unit conversion
  • PoS & GHG data
04

Reconcile & report

Retrieve mass-balance or PoO stock and support put-on-market and gas flows.

  • Stocks & stock loss
  • Put on market
  • Gas transactions
ALL VOLUNTARY SCHEMES

Every scheme. The same REST integration.

The API is designed for economic operators across all available voluntary schemes—not only ISCC EU—with onboarding help included.

Browse every endpoint
TEST to PROD

A guided route to production.

You do not have to decode the UDB onboarding process alone. Ademico helps align your voluntary scheme, NTR IDs, acceptance testing, and production-readiness evidence.

Test only what you plan to use

Validate the services your ERP needs, then promote that proven scope to Production.

Discuss your onboarding →
  1. 01
    REGISTERConfirm your organisation and NTR IDs

    Coordinate access with your voluntary scheme and the UDB team.

  2. 02
    CONNECTIntegrate in the TEST environment

    Use OAuth2 or Basic Authentication and start with the connectivity check.

  3. 03
    PROVEExercise your real UDB services

    Test the operations your organisation will use and keep the transmission evidence.

  4. 04
    GO LIVEMove the same integration to PROD

    Ademico supports the readiness package and production activation.

Developer ready from day one

The resources to start quickly. The experts to keep you moving.

Ademico has worked with UDB since the project started more than three years ago. The people supporting your integration understand both the API and the UDB business flows behind it.

Explore the API documentation →
FASTEST START

Postman collection included

Import the collection, configure the supplied TEST environment variables, and start trying supported API operations without building a client first.

  1. Import collection
  2. Set TEST credentials
  3. Send your first request
REFERENCE

Extensive documentation

OpenAPI specifications, request and response examples, integration guidance, business scenarios, and a detailed user guide.

REAL PEOPLE

Developer-led support

Get direct help with authentication, payloads, notifications, onboarding, and UDB-specific questions—including working sessions when useful.

UDB EXPERIENCE

There from the start

More than three years of hands-on UDB integration experience, following the exchange model as the project evolves.

Trusted by organisations using Ademico

Candy Innovit Empirys Cacesa Tech & Logistics
Simple annual plans

Build the integration before you commit.

Start in UDB Acceptance at no cost. Move to a production plan when the complete workflow is proven.

BUILD & VALIDATE

Free trial

{ }
€0/ trial

For development teams building and validating their UDB integration.

  • UDB TEST / Acceptance environment
  • Ademico UDB REST API
  • EU-hosted data on AWS
  • Integration support included
  • No credit card required
Start testing free
PRODUCTION
OPERATIONAL SCALE

Professional

A
€5,400/ year

For economic operators running UDB reporting from TEST through Production.

  • 40,000 UDB requests / year
  • TEST + Production environments
  • 99.9% availability
  • Support, maintenance & monitoring
  • Disaster recovery plan
  • EU-hosted data on AWS
Choose Professional
HIGHER VOLUME

Enterprise

∞
Customannual plan

For larger volumes, business-critical workflows, and priority assistance.

  • 40,000+ UDB requests / year
  • TEST + Production environments
  • 99.9% availability
  • Priority support included
  • Maintenance & monitoring
  • Disaster recovery plan
Request a quotation

What counts as a request? API calls that send data to UDB or retrieve data from UDB. Notifications and responses received from UDB do not count toward your allowance.

Clear answers

Before your developer starts.

Have a scheme, transaction flow, or architecture question that is not covered here?

Ask a UDB engineer →

No. Your application sends JSON through the Ademico REST API. Ademico transforms it into the UDB XML exchange model, validates it against the UDB XSD, packages it, and sends it through the managed Access Point.

No. In normal operations, your users and systems interact only with Ademico’s REST API. Ademico handles the UDB-specific XML, validation, secure delivery, and responses behind the scenes, so your familiar ERP or application remains the working interface.

Yes. As soon as UDB accepts a submission made through our API, the data is immediately visible in UDB to authorised users for inspection and verification. The UDB interface remains available as a transparent view of the records exchanged through Ademico.

Yes. Notifications are available through polling or webhooks. Webhook payloads use the same JSON notification format, and failed deliveries are retried automatically.

The REST API covers the UDB system-to-system operation set, including sourcing contacts, trade and transfer transactions, PoS and sustainability data, material processing and conversion, stock, put-on-market, certificate, and notification operations. The live OpenAPI reference is the source of truth for the current version.

The service and exchanged data are hosted in the AWS Ireland region. Ademico is ISO 27001 certified, and data is protected in transit and at rest.

Developers receive extensive API and integration documentation, an OpenAPI specification, request and response examples, a detailed user guide, and a Postman collection with a TEST environment configuration. Developer-led support is available throughout the integration.

Clear answers

Before your developer starts.

Your developers use our JSON REST API. Ademico manages the UDB XML and eDelivery infrastructure behind it.

Ask a UDB engineer →

No. Your application sends JSON through the Ademico REST API. Ademico transforms it into the UDB XML exchange model, validates it against the UDB XSD, packages it, and sends it through the managed Access Point.

No. Ademico operates the managed eDelivery Access Point and secure route to UDB. Your developers integrate only with our REST API—there is no Domibus or eDelivery infrastructure for your team to deploy, certify, monitor, or maintain.

No. In normal operations, your users and systems interact only with Ademico’s REST API. Ademico handles the UDB-specific XML, validation, secure delivery, and responses behind the scenes, so your familiar ERP or application remains the working interface.

Yes. As soon as UDB accepts a submission made through our API, the data is immediately visible in UDB to authorised users for inspection and verification. The UDB interface remains available as a transparent view of the records exchanged through Ademico.

Yes. Notifications are available through polling or webhooks. Webhook payloads use the same JSON notification format, and failed deliveries are retried automatically.

The REST API covers the UDB system-to-system operation set, including sourcing contacts, trade and transfer transactions, PoS and sustainability data, material processing and conversion, stock, put-on-market, certificate, and notification operations. The live OpenAPI reference is the source of truth for the current version.

The service and exchanged data are hosted in the AWS Ireland region. Ademico is ISO 27001 certified, and data is protected in transit and at rest.

Developers receive extensive API and integration documentation, an OpenAPI specification, request and response examples, a detailed user guide, and a Postman collection with a TEST environment configuration. Developer-led support is available throughout the integration.

Your UDB route can be simpler

Keep the business logic.
Hand us the exchange layer.

Start in TEST, validate the complete asynchronous workflow, and move the same REST integration to Production.

Start testing for free →