List invoices
List all invoices of a billing account.
Path Parameters
org_id string required
Query Parameters
billing_id string
ID of the billing account to list invoices for
nonzero_amount_only boolean
expand string[]
Responses
- 200
- 400
- 401
- 403
- 404
- 500
- default
A successful response.
application/json
Schema
Example (from schema)
Schema
invoices object[]
{
"invoices": [
{
"id": "string",
"customer_id": "string",
"provider_id": "string",
"state": "string",
"currency": "string",
"amount": "string",
"hosted_url": "string",
"due_date": "2024-07-13T09:54:48.257Z",
"effective_at": "2024-07-13T09:54:48.257Z",
"period_start_at": "2024-07-13T09:54:48.257Z",
"period_end_at": "2024-07-13T09:54:48.257Z",
"metadata": {},
"created_at": "2024-07-13T09:54:48.257Z",
"customer": {
"id": "string",
"org_id": "string",
"name": "string",
"email": "string",
"phone": "string",
"address": {
"line1": "string",
"line2": "string",
"city": "string",
"state": "string",
"postal_code": "string",
"country": "string"
},
"provider_id": "string",
"provider": "string",
"currency": "string",
"state": "string",
"tax_data": [
{
"type": "string",
"id": "string"
}
],
"metadata": {},
"created_at": "2024-07-13T09:54:48.257Z",
"updated_at": "2024-07-13T09:54:48.257Z",
"organization": {
"id": "string",
"name": "string",
"title": "string",
"metadata": {},
"created_at": "2023-06-07T05:39:56.961Z",
"updated_at": "2023-06-07T05:39:56.961Z",
"state": "enabled",
"avatar": "string"
}
}
}
]
}
Bad Request - The request was malformed or contained invalid parameters.
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Unauthorized - Authentication is required
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Forbidden - User does not have permission to access the resource
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Not Found - The requested resource was not found
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Internal Server Error. Returned when theres is something wrong with Frontier server.
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
application/json
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
GET /v1beta1/organizations/:org_id/billing/invoices
Authorization
name: Basic type: httpdescription: use Client ID as username and Client Secret as passwordin: headerscheme: basic
Request
Request
curl / cURL
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
python / requests
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
go / native
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
nodejs / axios
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
ruby / Net::HTTP
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
csharp / RestSharp
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
php / cURL
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
java / OkHttp
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'
powershell / RestMethod
curl -L -X GET 'http://127.0.0.1:7400/v1beta1/organizations/:org_id/billing/invoices' \
-H 'Accept: application/json'