Supplier API

Errors

The Mediloop APIs use standard HTTP status codes to indicate the outcome of a request. All error responses are returned in a consistent JSON format.

Error codes overview

HTTP Status	Code	Type	Description
400	BAD_REQUEST	Client Error	The request is invalid or cannot be processed.
401	UNAUTHORIZED	Client Error	Authentication is required or has failed.
403	FORBIDDEN	Client Error	You don't have permission to perform this action.
404	NOT_FOUND	Client Error	The requested resource was not found.
409	CONFLICT	Client Error	The request conflicts with the current state.
429	RATE_LIMITED	Rate Limit	Too many requests. Please try again later.
500	INTERNAL_ERROR	Server Error	An unexpected error occurred on our server.
503	SERVICE_UNAVAILABLE	Server Error	The service is temporarily unavailable.

Error response format

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The 'sku' field is required.",
    "details": "Missing required field: sku",
    "trace_id": "c1f2e3d4-5678-90ab-cdef-1234567890ab"
  }
}

Example responses

HTTP/1.1 400 Bad Request
Content-Type: application/json
X-Request-Id: c1f2e3d4-5678-90ab-cdef-1234567890ab

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The 'sku' field is required.",
    "details": "Missing required field: sku",
    "trace_id": "c1f2e3d4-5678-90ab-cdef-1234567890ab"
  }
}

Common error codes

INVALID_PARAMETER

A required field is missing or invalid.

UNAUTHORIZED

Credentials are missing or invalid.

FORBIDDEN

The key lacks the required scope.

RATE_LIMITED

Wait until the rate limit resets.

Best practices

If you receive an error you can’t resolve, contact support with the trace_id and request timestamp; never send your raw API key.