Custom label printed under a reference

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api.documentation.omnicado.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "omnicado MCP server": {
    "url": "https://api.documentation.omnicado.com/mcp"
  }
}

Close
GET /labels/custom/{reference}

Returns the label again. Supports the same Accept header as the order label.

Path parameters

  • reference string Required

    The reference the label was printed with

Responses

  • 200 application/json

    The label

    Hide response attributes Show response attributes object
    • orderId integer | null

      Omnicado order id; null for a custom label

    • reference string

      Order number, or the reference of a custom label

    • carrier string

      Carrier code, or the marketplace delivery (e.g. alzaDelivery)

    • labelFormat string

      The format the carrier actually returned

      Values are pdf, zpl, or unknown.

    • trackingNumbers array[string]
    • trackingUrl string | null
    • cancelled boolean

      Custom labels only

    • label object
      Hide label attributes Show label attributes object
      • contentType string

        Values are application/pdf, application/zpl, or application/octet-stream.

      • content string(byte)

        Base64 encoded label

  • 404 application/json

    label_not_found

    Hide response attributes Show response attributes object
    • error string
    • code string

      Machine-readable reason, listed with each response

  • 409 application/json

    label_in_progress

    Hide response attributes Show response attributes object
    • error string
    • code string

      Machine-readable reason, listed with each response

GET /labels/custom/{reference}
curl \
 --request GET 'api.services.omnicado.com/api/v2/labels/custom/ESHOP-2026-004211' \
 --header "X-OMNICADO-TOKEN: $API_KEY"
Response examples (200)
{
  "orderId": 1843311,
  "reference": "ESHOP-2026-004211",
  "carrier": "packeta",
  "labelFormat": "pdf",
  "trackingNumbers": [
    "Z1234567890"
  ],
  "trackingUrl": "https://tracking.packeta.com/cs/?id=Z1234567890",
  "cancelled": false,
  "label": {
    "contentType": "application/pdf",
    "content": "JVBERi0xLjQK..."
  }
}
Response examples (404)
{
  "error": "Carrier ppl is not installed on this account",
  "code": "carrier_not_installed"
}
Response examples (409)
{
  "error": "Carrier ppl is not installed on this account",
  "code": "carrier_not_installed"
}