latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

EUDR - Customers - Suppliers

Find suppliers by their IDs or references where at least one of the two parameters must be provided and maximum allowed is 100.

Find suppliers by providing either a list of target IDs or a list of references. Exactly one of the two parameters must be provided. The maximum number of allowed IDs or references is limited to 100. Returns a list of supplier details for the provided identifiers, including screening status, references, connection contacts, and supplier maturity when available.

Use Cases:

  • Look up suppliers by internal target IDs
  • Resolve suppliers by external reference codes
  • Retrieve supplier details for product or compliance workflows

Required permission: access_public_products

get/public/v2/eudr/customers/suppliers

Query parameters

targetIdsinteger

List of supplier target IDs. Must not be provided together with 'refs'. Maximum allowed: 100.

{"stackTrail":"paths:/public/v2/eudr/customers/suppliers:get:parameters:1:schema:items","oasType":"schema","type":"unknown"}

List of supplier references. Must not be provided together with 'targetIds'. Maximum allowed: 100.

Response

List of suppliers matching the provided IDs or references.

idinteger required

Supplier ID

namestring required

Supplier name

locationstring nullable

Supplier location

isPublicboolean required

Indicates if the supplier profile is public

screenedboolean required

Indicates if the supplier has been screened or not

Example response

[
  {
    "id": 101,
    "name": "Acme Corp",
    "location": "Vienna",
    "isPublic": true,
    "organization": {
      "id": 201,
      "name": "Global Supplies Inc.",
      "location": "New York"
    },
    "screened": true,
    "references": [
      {
        "id": "REF-001",
        "source": "SAP"
      }
    ],
    "connectionContacts": [
      {
        "id": 42,
        "email": "contact@example.com"
      }
    ]
  }
]