# Orders

Order operations

## Get Orders List

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

```json
{"openapi":"3.1.0","info":{"title":"Tribute API","version":"1.0.0"},"tags":[{"name":"Orders","description":"Order operations"}],"servers":[{"url":"https://tribute.tg/api/v1","description":"Tribute API v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"API key for authentication."}},"schemas":{"Order":{"type":"object","required":["id","status","created","fullName","email","phone","telegramID","address","locality","fullAddress","customerNote","items","deliveryCost","currency"],"properties":{"id":{"type":"integer","description":"Unique order identifier"},"status":{"type":"string","description":"Order status","enum":["pending","shipped","delivered","canceled","refunded"]},"created":{"type":"string","format":"date-time","description":"Order creation date and time"},"fullName":{"type":"string","description":"Recipient full name"},"email":{"type":"string","format":"email","description":"Recipient email"},"phone":{"type":"string","description":"Recipient phone"},"telegramID":{"type":"integer","format":"int64","description":"Buyer's Telegram ID"},"address":{"type":"object","description":"Delivery address","properties":{"countryIso2":{"type":"string","description":"Two-letter ISO country code"},"countryIso3":{"type":"string","description":"Three-letter ISO country code"}}},"locality":{"type":"string","description":"City"},"fullAddress":{"type":"string","description":"Full delivery address"},"customerNote":{"type":"string","description":"Customer note"},"items":{"type":"array","description":"Order items","items":{"$ref":"#/components/schemas/OrderItem"}},"deliveryCost":{"type":"number","format":"float","description":"Delivery cost"},"currency":{"type":"string","description":"Order currency"}}},"OrderItem":{"type":"object","required":["id","price","quantity","currency","name","attributes"],"properties":{"id":{"type":"integer","description":"Product variant ID"},"price":{"type":"number","format":"float","description":"Unit price"},"quantity":{"type":"integer","format":"int64","description":"Quantity"},"currency":{"type":"string","description":"Currency"},"name":{"type":"string","description":"Product name"},"attributes":{"type":"object","description":"Product attributes (size, color, etc.)","additionalProperties":{"type":"string"}}}},"Meta":{"type":"object","required":["total","offset","limit"],"properties":{"total":{"type":"integer","format":"int64","description":"Total number of records"},"offset":{"type":"integer","format":"int64","description":"Page number"},"limit":{"type":"integer","format":"int64","description":"Number of records per page"}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","description":"Error code","enum":["error_bad_request","error_not_found","error_not_permitted","no_access"]},"message":{"type":"string","description":"Error description"}}}}},"paths":{"/physical/orders":{"get":{"summary":"Get Orders List","description":"Returns a list of physical orders for the current user with pagination","tags":["Orders"],"parameters":[{"name":"lastOrderId","in":"query","description":"ID of the last order for cursor pagination","required":false,"schema":{"type":"string"}},{"name":"status","in":"query","description":"Filter by order status (multiple values allowed)","required":false,"schema":{"type":"array","items":{"type":"string","enum":["pending","shipped","delivered","canceled","refunded"]}},"style":"form","explode":true},{"name":"limit","in":"query","description":"Number of records per page (maximum 50)","required":false,"schema":{"type":"integer","default":50,"maximum":50}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"integer","default":1}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"Bad request (invalid status)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized (invalid API key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Get Order Details

> Returns detailed information about a specific order

```json
{"openapi":"3.1.0","info":{"title":"Tribute API","version":"1.0.0"},"tags":[{"name":"Orders","description":"Order operations"}],"servers":[{"url":"https://tribute.tg/api/v1","description":"Tribute API v1"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"API key for authentication."}},"schemas":{"Order":{"type":"object","required":["id","status","created","fullName","email","phone","telegramID","address","locality","fullAddress","customerNote","items","deliveryCost","currency"],"properties":{"id":{"type":"integer","description":"Unique order identifier"},"status":{"type":"string","description":"Order status","enum":["pending","shipped","delivered","canceled","refunded"]},"created":{"type":"string","format":"date-time","description":"Order creation date and time"},"fullName":{"type":"string","description":"Recipient full name"},"email":{"type":"string","format":"email","description":"Recipient email"},"phone":{"type":"string","description":"Recipient phone"},"telegramID":{"type":"integer","format":"int64","description":"Buyer's Telegram ID"},"address":{"type":"object","description":"Delivery address","properties":{"countryIso2":{"type":"string","description":"Two-letter ISO country code"},"countryIso3":{"type":"string","description":"Three-letter ISO country code"}}},"locality":{"type":"string","description":"City"},"fullAddress":{"type":"string","description":"Full delivery address"},"customerNote":{"type":"string","description":"Customer note"},"items":{"type":"array","description":"Order items","items":{"$ref":"#/components/schemas/OrderItem"}},"deliveryCost":{"type":"number","format":"float","description":"Delivery cost"},"currency":{"type":"string","description":"Order currency"}}},"OrderItem":{"type":"object","required":["id","price","quantity","currency","name","attributes"],"properties":{"id":{"type":"integer","description":"Product variant ID"},"price":{"type":"number","format":"float","description":"Unit price"},"quantity":{"type":"integer","format":"int64","description":"Quantity"},"currency":{"type":"string","description":"Currency"},"name":{"type":"string","description":"Product name"},"attributes":{"type":"object","description":"Product attributes (size, color, etc.)","additionalProperties":{"type":"string"}}}},"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string","description":"Error code","enum":["error_bad_request","error_not_found","error_not_permitted","no_access"]},"message":{"type":"string","description":"Error description"}}}}},"paths":{"/physical/orders/{id}":{"get":{"summary":"Get Order Details","description":"Returns detailed information about a specific order","tags":["Orders"],"parameters":[{"name":"id","in":"path","description":"Order ID","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Bad request (order ID not provided)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized (invalid API key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Order not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```