List Exchange Orders

GET /api/v1/exchanges/orders

Returns a list of exchange orders filtered by the provided query parameters.

Headers

Header	Required	Value
api-key	yes	Orders API key

Query parameters

All parameters are optional.

Date / time filters

Parameter	Type	Description
order_timestamp_from	int	UNIX timestamp — orders created at or after this time
order_timestamp_to	int	UNIX timestamp — orders created at or before this time
status_timestamp_from	int	UNIX timestamp — orders last updated at or after this time
status_timestamp_to	int	UNIX timestamp — orders last updated at or before this time
delivery_timestamp_from	int	UNIX timestamp — orders delivered at or after this time
delivery_timestamp_to	int	UNIX timestamp — orders delivered at or before this time

Status filters

Parameter	Type	Allowed values
status	string	processing, sent, delivered, cancelled
payment_status	string	paid_in_one, fully_paid, in_progress, failed
order_type	string	normal, manual
shipment	string	standard, door_to_door, pickup
exchange_status	string	pending, approved, denied

Note

door_to_door and pickup shipment types currently always return an empty result set.

Other filters

Parameter	Type	Description
order_id	int	Filter by order number
driver_id	string	Filter by Uber provider ID (social account)
tracking	string	Filter by tracking number (exact match)
country	string	ISO country code (e.g. HU, AT)
city	string	Partial city name match
partner_name	string	Filter by partner name (exact match)

Pagination

Parameter	Type	Description
limit	int	Results per page. Min: 1, max: 200. Default: 200
page	int	Page number. Default: 1
skip	int	Number of records to skip (requires limit)

Status mappings

API value	Internal statuses
processing	PROCESSING, PAID
sent	FORWARDED, SENT
delivered	DELIVERED, MANUAL_DELIVERED
cancelled	CANCELLED

Response

HTTP 200 OK

[
  {
    "order_timestamp": 1748300000,
    "driver_id": "abc123",
    "addresses": [
      {
        "type": "shipping",
        "first_name": "John",
        "last_name": "Doe",
        "country": "Hungary",
        "zip": "1011",
        "city": "Budapest",
        "street": "Fő utca",
        "house_number": "1",
        "floor": "2",
        "door": "5",
        "phone": "+36201234567"
      }
    ],
    "status": "sent",
    "status_timestamp": 1748350000,
    "status_history": [
      {
        "status_id": 2,
        "status": "processing",
        "timestamp": 1748300000
      },
      {
        "status_id": 4,
        "status": "sent",
        "timestamp": 1748350000
      }
    ],
    "tracking": "TRACK123456",
    "order_id": "100042",
    "ordered_products": [
      {
        "category_name": "Grocery",
        "is_branded": true,
        "product_name": "Example Product",
        "quantity": 2,
        "has_bag": true
      }
    ],
    "payment_status": "Paid in 1",
    "local_currency": "HUF",
    "paid_in_local_currency": "4990.00",
    "paid_in_eur": "12.50",
    "shipment": "Standard",
    "delivery_failures": [],
    "delivery_date": 1748360000,
    "subscription_status": "",
    "subscription_delay": "",
    "eats_pro_discount_percent": "10",
    "total_savings": "5.00",
    "amount_paid_total": "4990.00",
    "subsidization": "0",
    "wyb_discount": "0",
    "uber_tier": "Gold",
    "has_bag": true,
    "uber_id": "UBER-998877",
    "partner_name": "Random Partner",
    "channel": "webshop",
    "user_id": 12345,
    "agency_id": "AGENCY-4432",
    "exchange_status": "Approved",
    "exchange_product_statuses": [
      {
        "product_name": "Delivery bag with rain cover - Adecco",
        "wrong_size": 0,
        "warranty": 1,
        "lost": 0,
        "other": 0,
        "status": "Torn fabric or seams",
        "exchange_timestamp": 1775808581,
        "images": [
          "https://sa.uber.boolanga.com/storage/197/a18243dd-bff6-4567-b837-60d064175294.jpeg"
        ]
      }
    ]
  }
]

Response field reference

Field	Type	Description
order_timestamp	int	Order creation time as UNIX timestamp
driver_id	string	Uber provider ID of the assigned driver
addresses	array	Shipping/billing addresses
status	string	Current delivery status
status_timestamp	int	UNIX timestamp of the last status change
status_history	array	Full delivery status history, oldest first. Each entry has status_id, status (name) and timestamp
tracking	string	Latest tracking number
order_id	string	Order number
ordered_products	array	Items with has_bag = 1
payment_status	string	Paid in 1, Pay later, Fully paid, In progress (x/y), Failed (x/y)
local_currency	string	ISO currency code (e.g. HUF)
paid_in_local_currency	string	Sum of bag items in local currency
paid_in_eur	string	Sum of bag items converted to EUR
shipment	string	Always "Standard" currently
delivery_failures	array	Failed delivery attempts
delivery_date	int|string	UNIX timestamp of delivery, or empty string if not delivered
subscription_status	string	Payment subscription status, or empty string if none
subscription_delay	string	failed (30 day delay) for overdue Stripe installments, otherwise empty string
eats_pro_discount_percent	string	Eats Pro (tier) discount percent. Empty string when the tier_discount feature is disabled
total_savings	string	Total savings (subsidization + WYB discounts). Empty string when tier_discount is disabled
amount_paid_total	string	Sum of bag items (same as paid_in_local_currency)
subsidization	string	Total subsidization on delivery and items
wyb_discount	string	Total WYB discount on items
uber_tier	string	Mapped Uber tier name, or - when the tier_discount feature is disabled
has_bag	bool	Whether the order has at least one bag item
uber_id	string	Uber ID of the customer, or empty string if not set
partner_name	string	Name of the partner the order belongs to, or empty string if none
channel	string|null	Channel of the order’s first user product, or null if none
user_id	int	Internal user ID (primary key), or empty string if the order has no associated user
agency_id	string	Agency ID of the customer, or empty string if not set
exchange_status	string	Pending, Approved, Denied
exchange_product_statuses	array	Product exchanges

HTTP error codes

Status	Description
401	Missing api-key header
403	Invalid api-key value
422	Validation error