List all orders

GET https://api.tamio.com/v2/orders/list

Returns a paginated list of orders (pending/draft invoices) with filtering options including date ranges, customer, currency, price ranges, and payment gateway.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

from string

Start date for date range filter (ISO format or Unix timestamp)

to string

End date for date range filter (ISO format or Unix timestamp)

customer_id string

Filter by customer UUID

currency string

Filter by currency code

minimum_price number

Minimum total amount filter

maximum_price number

Maximum total amount filter

gateway string

Filter by payment gateway/method used

Responses

200 Orders retrieved successfully

Orders retrieved successfully

status integer

invoices array of PendingOrder

id string

Order UUID

date integer

Order creation date as Unix timestamp

order_id integer

Numeric order ID

pay_link string

Payment link URL for the order

status string

Order status

type string

Order type (one_time or recurring)

400 Bad request – validation or business-logic error

401 Missing or invalid API key

Bulk delete invoices

Retrieve an order

/orders/list

1 const response = await fetch("https://api.tamio.com/v2/orders/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/orders/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "invoices": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "date": 1700000000,
      "order_id": 1042,
      "pay_link": "https://pay.example.com/inv_b2c3d4e5",
      "status": "initialised",
      "type": "one_time"
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/orders/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/orders/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body