Distribution

List distribution destinations

GET/distribution/destinations

Distribution destinations available to the api-key's linked user (feed targets such as ONIX/metadata drops). FTP credentials are never returned. Destinations are server-wide — the data model has no per-usergroup destination — so every caller with distribution access sees the same set. Requires the read scope and the linked user's distribution permission (dm or dv).

X-Api-Key<token>

Issued to you when your integration is provisioned. Determines which catalogue resources are visible and which AI tools are available.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/distribution/destinations"
{  "success": true,  "status": "success",  "message": "Success",  "data": {    "items": [      {        "ref": 3,        "name": "ONIX feed",        "format": "ONIX",        "transport": "sftp",        "enabled": true      },      {        "ref": 5,        "name": "FTP drop",        "format": "Standard",        "transport": "ftp",        "enabled": true      }    ],    "total": 2  }}

{  "success": false,  "status": "fail",  "message": "API key is required",  "error": {    "code": "NO_API_KEY",    "message": "API key is required"  }}

{  "success": false,  "status": "fail",  "message": "This API key does not have the 'write' scope",  "error": {    "code": "INSUFFICIENT_SCOPE",    "message": "This API key does not have the 'write' scope"  }}