Label already printed for an order

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/order/{orderId}

Returns the stored label without printing anything. Send Accept: application/pdf (or application/zpl, application/octet-stream) to get the file itself instead of JSON; the tracking numbers then come in the X-Tracking-Numbers header.

Path parameters

  • orderId integer Required

    Omnicado order id

Responses

  • 200 application/json

    The stored 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

    order_not_found, or label_not_found when the order has no label yet

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

      Machine-readable reason, listed with each response

GET /labels/order/{orderId}
curl \
 --request GET 'api.services.omnicado.com/api/v2/labels/order/1843311' \
 --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"
}