Get order

Read one order: items, status, shipping and the message thread with the buyer.

GET https://cotlet.dev/api/v1/discogs/orders/{order_id}

read

Returns the items, current status, shipping details and the buyer messages in order. Use it before changing a status, because a status cannot move back to an earlier one.

Parameters

Parameters: get_order
NameTypeDescription
order_id string required string Order ID from list_orders, e.g. '1234567-89'.

Request

cURL
curl https://cotlet.dev/api/v1/discogs/orders/1234567-89 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("discogs", "get_order", {"order_id":"1234567-89"})
Node.js
const result = await cotlet.call('discogs', 'get_order', {"order_id":"1234567-89"});
CLI
cotlet call discogs get_order --data '{"order_id":"1234567-89"}'

Example response

JSON

{
  "order_id": "1234567-89",
  "status": "Payment Received",
  "items": [
    {
      "release_id": 4417820,
      "title": "Night Drive / Blue Room"
    }
  ],
  "messages": [
    {
      "from": "sample_buyer",
      "text": "Can you ship this week?",
      "at": "2026-10-14T10:02:00Z"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.