List inbox conversations

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 /inbox/tickets
Omnicado token based scheme

Returns conversations (tickets) of the account, newest activity first. Messages are returned only by the ticket detail. Reading through the API never marks a ticket as read.

Query parameters

  • mailboxId integer

    Only tickets of this mailbox (selling channel ID)

  • status string

    Values are open, waiting_for_seller, waiting_for_buyer, closed, accepted, or rejected.

  • unread boolean

    true returns only unread tickets, false only read ones

  • page integer

    Page number, starting at 1

    Default value is 1.

  • limit integer

    Items per page

    Default value is 50.

Responses

  • 200 application/json

    Page of tickets

    Hide response attributes Show response attributes object
    • total integer
    • page integer
    • limit integer
    • items array[object]
      Hide items attributes Show items attributes object
      • id integer
      • mailboxId integer
      • source string

        Values are allegro_messaging, allegro_issue, or kaufland_ticket.

      • status string

        Values are open, waiting_for_seller, waiting_for_buyer, closed, accepted, or rejected.

      • remoteId string

        Conversation ID on the marketplace

      • subject string | null
      • buyerLogin string | null
      • orderId integer | null

        Omnicado order ID, when the conversation is paired with an order

      • remoteOrderId string | null
      • isRead boolean
      • lastMessageAt string(date-time) | null
      • replyDueAt string(date-time) | null
      • lastReplyError string | null

        Why the last reply was refused by the marketplace; cleared after a successful reply

      • lastReplyErrorAt string(date-time) | null
  • 400

    Unknown status

  • 404

    Mailbox not found

GET /inbox/tickets 
curl \
 --request GET 'api.services.omnicado.com/api/v2/inbox/tickets' \
 --header "X-OMNICADO-TOKEN: $API_KEY"
Response examples (200) 
{
  "total": 128,
  "page": 1,
  "limit": 50,
  "items": [
    {
      "id": 4521,
      "mailboxId": 727,
      "source": "allegro_messaging",
      "status": "open",
      "remoteId": "string",
      "subject": "string",
      "buyerLogin": "string",
      "orderId": 42,
      "remoteOrderId": "string",
      "isRead": true,
      "lastMessageAt": "2026-05-04T09:42:00Z",
      "replyDueAt": "2026-05-04T09:42:00Z",
      "lastReplyError": "string",
      "lastReplyErrorAt": "2026-05-04T09:42:00Z"
    }
  ]
}