Data Exchange

API Docs (CTC)

Available API endpoints and their usage

Product Lists

Get All Product Lists

Product

Request the list of products

Create a Product

Find a Product

Update a Product

Classification Types

Products can have different classification types in their classification field:

Comparable vZTA (cmp_vzta)

{
  "type": "cmp_vzta",
  "bti": "BTI_ID",
  "ctn": "8504408390",
  "ctn_8": "85044083",
  "ctn_10": "8504408390",
  "ctn_format": "10-digit",
  "tradename2": "",
  "comment": "",
  "is_fixed": true,
  "is_av3": false,
  "status": "classified",
  "tradename": "Product name",
  "reason": "Comparison with vZTA",
  "valid_from": "2025-01-01",
  "valid_until": "2026-01-01",
  "bti_found": "BTI_REF_ID"
}

Granted vZTA (grt_vzta)

{
  "type": "grt_vzta",
  "bti": "BTI_ID",
  "ctn": "8504408390",
  "ctn_8": "85044083",
  "ctn_10": "8504408390",
  "ctn_format": "10-digit",
  "tradename2": "",
  "comment": "",
  "is_fixed": true,
  "is_av3": false,
  "reason": "Granted vZTA",
  "valid_from": "2025-01-01",
  "valid_until": "2026-01-01",
  "status": "classified",
  "tradename": "Product name",
  "bti_found": "BTI_REF_ID"
}

Manual Classification

{
  "type": "manual",
  "ctn": "8504408390",
  "ctn_8": "85044083",
  "ctn_10": "8504408390",
  "ctn_format": "10-digit",
  "tradename2": "",
  "reason": "Manual classification",
  "features": "Product features",
  "comment": "",
  "is_fixed": true,
  "is_av3": false,
  "status": "classified",
  "tradename": "Product name"
}

Special Classification

{
  "type": "special",
  "ctn": "8504408390",
  "ctn_8": "85044083",
  "ctn_10": "8504408390",
  "ctn_format": "10-digit",
  "tradename2": "",
  "comment": "Special case",
  "is_fixed": true,
  "is_av3": false,
  "status": "classified",
  "tradename": "Product name"
}

Error Responses

All endpoints return error responses in the following format:

{
  "reason": "Error description message"
}

Common HTTP status codes:

  • 400 Bad Request: Invalid parameters or malformed request
  • 401 Unauthorized: Missing or invalid authentication token
  • 404 Not Found: Resource not found
  • 422 Unprocessable Entity: Validation errors
  • 500 Internal Server Error: Server-side error