Skip to main content
AgriBackup’s supplier mapping registry links your internal ERP vendor identifiers to the official EU TRACES NT Operator UUIDs required for EUDR traceability. Use this endpoint to retrieve the full list of supplier mappings currently registered on your organization. You can use the returned records to verify existing mappings, audit your supply chain coverage, or look up the internal id needed to retrieve a specific mapping with the Get Supplier endpoint. GET /api/v1/enterprise/eudr/suppliers

​
Request Parameters

This endpoint accepts no request body and no query parameters.

​
Code Examples

import agribackup
from agribackup.rest import ApiException

configuration = agribackup.Configuration(host="https://live.agribackup.com/api/v1")
configuration.api_key["ApiKeyAuth"] = "sk_live_YOUR_API_KEY"

with agribackup.ApiClient(configuration) as api_client:
    try:
        api_instance = agribackup.EnterpriseSuppliersApi(api_client)
        response = api_instance.list_suppliers()
        for supplier in response:
            print(f"{supplier.vendor_id} -> {supplier.operator_uuid}")
    except ApiException as e:
        print("Exception when calling API: %s\n" % e)

import { AgriBackupClient } from "@agribackup/sdk";

const client = new AgriBackupClient({
  apiKey: "sk_live_YOUR_API_KEY",
  baseUrl: "https://live.agribackup.com/api/v1",
});

async function listSuppliers() {
  try {
    const suppliers = await client.suppliers.listSuppliers();
    suppliers.forEach((s) =>
      console.log(`${s.vendorId} -> ${s.operatorUuid}`)
    );
  } catch (error) {
    console.error(error);
  }
}

listSuppliers();

curl --request GET \
  --url https://live.agribackup.com/api/v1/enterprise/eudr/suppliers \
  --header "Authorization: Bearer sk_live_YOUR_API_KEY"

​
Response

A 200 OK response returns an array of supplier mapping objects. An empty array ([]) means no suppliers have been registered yet. 
[
  {
    "id": "sup_11aabbccddee",
    "vendorId": "VEND-1001",
    "operatorUuid": "123e4567-e89b-12d3-a456-426614174000",
    "companyName": "Acme Sourcing Ltd",
    "taxId": "TAX-1234",
    "countryCode": "KEN",
    "parentVendorId": null
  },
  {
    "id": "sup_22ffgghhiijj",
    "vendorId": "VEND-1002",
    "operatorUuid": "987fcdeb-51a2-43d8-b123-111222333444",
    "companyName": "Highland Coffee Cooperative",
    "taxId": "TAX-5678",
    "countryCode": "ETH",
    "parentVendorId": "VEND-1001"
  }
]
​
id
string
The unique internal AgriBackup identifier for this supplier mapping record.
​
vendorId
string
Your internal ERP Vendor ID that was used to create this mapping. This is the identifier used within your own systems to refer to this supplier.
​
operatorUuid
string
The official EU TRACES NT Operator UUID associated with this supplier. This UUID is required by the TRACES NT system for DDS filing and supply chain linkage.
​
companyName
string
The registered company name of the supplier as provided at mapping time.
​
taxId
string
The supplier’s Tax Identification Number. May be null if not provided at registration.
​
countryCode
string
The ISO-3166-1 alpha-3 country code of the supplier’s country of registration (e.g., KEN, ETH, BRA). May be null if not provided at registration.
​
parentVendorId
string
The ERP Vendor ID of this supplier’s parent in the chain of custody hierarchy, if applicable. Returns null for top-level (Tier-1) suppliers.

​
Error Responses

HTTP StatusError CodeDescription
401 UnauthorizedUNAUTHORIZEDThe Authorization header is absent or the bearer token is not recognised.
403 ForbiddenFORBIDDENYour API key does not have the required scope to list supplier mappings.
429 Too Many RequestsRATE_LIMITEDYou have exceeded the hourly rate limit. Check X-RateLimit-Reset for your reset time.
{
  "code": "UNAUTHORIZED",
  "message": "Missing or invalid API key",
  "details": []
}