Skip to main content
GET
/
invoices
/
bill_runs
List invoices eligible for bill run
curl --request GET \
  --url https://api.togai.com/invoices/bill_runs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "inv.hkgkgyh.ghg",
      "customerId": "7VcRw9xZDIqsC5E",
      "ownerId": "ACC001",
      "invoiceClass": "INVOICE",
      "invoiceType": "AD_HOC",
      "status": "DUE",
      "finalizingStatus": "FINALIZED",
      "totalAmount": 100,
      "paidAmount": 0,
      "startDate": "2020-07-04T12:00:00.000Z",
      "endDate": "2020-07-04T12:00:00.000Z",
      "invoiceDate": "2020-07-04T12:00:00.000Z",
      "generatedAt": "2020-07-04T12:00:00.000Z",
      "updatedAt": "2020-07-04T12:00:00.000Z"
    }
  ],
  "nextToken": "eyJsYXN0SXRlbUlkIjogInN0cmluZyIsICJwYWdlU2l6ZSI6IDEyMywgInNvcnRPcmRlciI6ICJhc2MifQ=="
}

Documentation Index

Fetch the complete documentation index at: https://docs.togai.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
nextToken
string

Pagination token used as a marker to get records from next page.

Example:

"eyJsYXN0SXRlbUlkIjogInN0cmluZyIsICJwYWdlU2l6ZSI6IDEyMywgInNvcnRPcmRlciI6ICJhc2MifQ=="

​
status
string

Filter option to filter by status.

​
owner_id
string

Filter option to filter based on owner id.

Example:

"ACC001"

​
customer_id
string

Filter option to filter based on customer id.

Example:

"1234"

​
pageSize
integer

Maximum page size expected by client to return the record list.

NOTE: Max page size cannot be more than 50. Also 50 is the default page size if no value is provided.

Example:

10

​
start_time
integer<int64>

Start time filter in epoch milli seconds

Example:

1650110402000

​
end_time
integer<int64>

End time filter in epoch milli seconds

Example:

1650110402000

Response

Response for Get invoice requests

List invoices response

​
data
object[]
required
Maximum array length: 50
​
nextToken
string
Maximum string length: 500
Example:

"eyJsYXN0SXRlbUlkIjogInN0cmluZyIsICJwYWdlU2l6ZSI6IDEyMywgInNvcnRPcmRlciI6ICJhc2MifQ=="