List all invoices

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

Returns a paginated list of invoices with comprehensive filtering options including date ranges, customer, product, subscription, payment status, currency, price ranges, and more.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

sort_by string

pricedateboughtinvoice_idname

filter string

Text search against invoice numbers, customer names, or product names

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

client_id string

Filter by client UUID (for agency/multi-client setups)

subscription_id string

Filter by subscription UUID (for recurring invoices)

product_id string

Filter by product UUID

warehouse_id string

Filter by warehouse/fulfillment location UUID

discount_id string

Filter by discount code UUID

shipping_id string

Filter by shipping method UUID

domain_id string

Filter by domain/site UUID

payout_id string

Filter by payout batch UUID

asset_id string

Filter by digital asset UUID

site_id string

Filter by website/storefront UUID

affiliate_partner_id string

Filter by affiliate partner UUID

affiliate_program_id string

Filter by affiliate program UUID

public_affiliate_program_id string

Filter by public affiliate program UUID

instalment_plan_id string

Filter by instalment payment plan UUID

processing_orders boolean

Include only orders currently being processed

past_orders boolean

Include only completed/historical orders

affiliate_sales boolean

Include only invoices generated through affiliate sales

currency string

Filter by currency code

minimum_price number

Minimum total amount filter

maximum_price number

Maximum total amount filter

shipping string

Filter by shipping status

enableddisabled

status string

Filter by payment status

paidunpaid

gateway string

Filter by payment gateway/method used

attributes array of string

Additional data to include in each invoice object

Responses

200 Invoices retrieved successfully

Invoices retrieved successfully

status integer

total_results integer

Total number of invoices matching the query

invoices array of Invoice

400 Bad request. Possible `error_code` values:

Bad request. Possible error_code values:

Code	Description
`1002`	ResourceNotFound

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Retrieve an invoice

/invoices/list

1 const response = await fetch("https://api.tamio.com/v2/invoices/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/invoices/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,
  "total_results": 42,
  "invoices": []
}

1	const response = await fetch("https://api.tamio.com/v2/invoices/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/invoices/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