Skip to main content
When you need to inspect or confirm the details of a single supplier mapping — for example, to verify the associated EU Operator UUID before submitting a DDS, or to check a supplier’s country classification — use this endpoint to retrieve the full record by its vendorId. The path parameter accepts the ERP Vendor ID string that was used when the mapping was originally registered. GET /api/v1/enterprise/eudr/suppliers/{vendorId}

​
Path Parameters

​
vendorId
string
required
The ERP Vendor ID used to identify the supplier mapping you want to retrieve. This is the same vendorId string that was submitted when calling Register Supplier Mapping.Example: VEND-1002

​
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"

vendor_id = "VEND-1002"

with agribackup.ApiClient(configuration) as api_client:
    try:
        api_instance = agribackup.EnterpriseSuppliersApi(api_client)
        response = api_instance.get_supplier(vendor_id=vendor_id)
        print(f"Company: {response.company_name}, Operator UUID: {response.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 getSupplier(vendorId) {
  try {
    const supplier = await client.suppliers.getSupplier(vendorId);
    console.log(`Company: ${supplier.companyName}, Operator UUID: ${supplier.operatorUuid}`);
  } catch (error) {
    console.error(error);
  }
}

getSupplier("VEND-1002");

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

​
Response

A 200 OK response returns the full supplier mapping object for the requested vendorId. 
{
  "id": "sup_11aabbccddee",
  "vendorId": "VEND-1002",
  "operatorUuid": "123e4567-e89b-12d3-a456-426614174000",
  "companyName": "Acme Sourcing Ltd",
  "taxId": "TAX-1234",
  "countryCode": "KEN",
  "parentVendorId": "VEND-1001"
}
​
id
string
The unique internal AgriBackup identifier for this supplier mapping record.
​
vendorId
string
The ERP Vendor ID as registered, confirming the requested mapping was found.
​
operatorUuid
string
The official EU TRACES NT Operator UUID bound to this vendor ID. This value is referenced during DDS submission to identify the supplier within the TRACES NT system.
​
companyName
string
The legal registered company name of the supplier.
​
taxId
string
The supplier’s Tax Identification Number. Returns null if one was not provided at registration.
​
countryCode
string
The ISO-3166-1 alpha-3 country code of the supplier’s country of registration. Returns null if not provided at registration.
​
parentVendorId
string
The ERP Vendor ID of the parent supplier in the chain of custody hierarchy. Returns null for top-level suppliers or where no parent was specified.

​
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 read supplier mappings.
404 Not FoundNOT_FOUNDNo supplier mapping with the provided vendorId exists for your organization. Check the vendor ID or use the List Suppliers endpoint to view all registered mappings.
429 Too Many RequestsRATE_LIMITEDYou have exceeded the hourly rate limit. Check X-RateLimit-Reset for your reset time.
{
  "code": "NOT_FOUND",
  "message": "Supplier mapping not found",
  "details": [
    {
      "code": "VENDOR_NOT_FOUND",
      "field": "vendorId",
      "issue": "No supplier mapping with vendorId 'VEND-1002' exists for this organization"
    }
  ]
}