List Organization Invoices

get/v1/billing/invoices/{org_id}

Requires admin or owner role.

Authentication

Authenticate in any one of these ways — not all of them:

API key in the X-API-Key header.
Bearer token in the Authorization header.

Path parameters

Name	Type	Description
`org_id`required	string	Org Id

Query parameters

Name	Type	Description
`limit`optional	integer	Number of invoices to return Default: `10`

Example request

curl

curl -X GET "https://api.robosystems.ai/v1/billing/invoices/{org_id}" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

Field Type Description

invoicesrequired

Invoice[]

List of invoices

Invoice fields

Field Type Description

idrequired

string

Invoice ID

numberoptional

string

Invoice number

statusrequired

string

Invoice status (paid, open, void, uncollectible)

amount_duerequired

integer

Amount due in cents

amount_paidrequired

integer

Amount paid in cents

currencyrequired

string

Currency code (usd)

createdrequired

string

Invoice creation date (ISO format)

due_dateoptional

string

Invoice due date (ISO format)

paid_atoptional

string

Payment date (ISO format)

invoice_pdfoptional

string

PDF download URL

hosted_invoice_urloptional

string

Hosted invoice URL

line_itemsrequired

InvoiceLineItem[]

Invoice line items

InvoiceLineItem fields

Field	Type	Description
`description`required	string	Line item description
`amount`required	integer	Amount in cents
`quantity`required	integer	Quantity
`period_start`optional	string	Billing period start
`period_end`optional	string	Billing period end

subscription_idoptional

string

Associated subscription ID

total_countrequired

integer

Total number of invoices

has_morerequired

boolean

Whether more invoices are available

Status	Meaning
400	Invalid request
401	Authentication required
403	Access denied
404	Resource not found
422	Validation Error
429	Rate limit exceeded
500	Internal server error