Orders

Order operations

Get Orders List

get

Returns a list of physical orders for the current user with pagination

Authorizations
Query parameters
lastOrderIdstringOptional

ID of the last order for cursor pagination

limitinteger · max: 50Optional

Number of records per page (maximum 50)

Default: 50
pageintegerOptional

Page number

Default: 1
Responses
200
Successful response
application/json
get
GET /api/v1/physical/orders HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "rows": [
    {
      "id": 12345,
      "status": "pending",
      "created": "2024-01-15T10:30:00Z",
      "fullName": "John Doe",
      "email": "[email protected]",
      "phone": "+1234567890",
      "telegramID": 123456789,
      "address": {
        "countryIso2": "US",
        "countryIso3": "USA"
      },
      "locality": "New York",
      "fullAddress": "USA, New York, 5th Avenue, 123, Apt 45",
      "customerNote": "Please call before delivery",
      "items": [
        {
          "id": 567,
          "price": 150,
          "quantity": 2,
          "currency": "USD",
          "name": "T-shirt with print",
          "attributes": {
            "size": "L",
            "color": "Black"
          }
        }
      ],
      "deliveryCost": 25.5,
      "currency": "USD"
    }
  ],
  "meta": {
    "total": 125,
    "offset": 1,
    "limit": 50
  }
}

Get Order Details

get

Returns detailed information about a specific order

Authorizations
Path parameters
idintegerRequired

Order ID

Responses
200
Successful response
application/json
get
GET /api/v1/physical/orders/{id} HTTP/1.1
Host: tribute.tg
Api-Key: YOUR_API_KEY
Accept: */*

{
  "id": 12345,
  "status": "pending",
  "created": "2024-01-15T10:30:00Z",
  "fullName": "John Doe",
  "email": "[email protected]",
  "phone": "+1234567890",
  "telegramID": 123456789,
  "address": {
    "countryIso2": "US",
    "countryIso3": "USA"
  },
  "locality": "New York",
  "fullAddress": "USA, New York, 5th Avenue, 123, Apt 45",
  "customerNote": "Please call before delivery",
  "items": [
    {
      "id": 567,
      "price": 150,
      "quantity": 2,
      "currency": "USD",
      "name": "T-shirt with print",
      "attributes": {
        "size": "L",
        "color": "Black"
      }
    }
  ],
  "deliveryCost": 25.5,
  "currency": "USD"
}
PreviousAPI DocumentationNextWebhooks