List billing schedules

GET/revenue/billing-schedules

Returns all billing schedules for the tenant. Each schedule defines a recurring billing event tied to a subscription, including the billing date, amount, and current status. Use to monitor upcoming invoicing events or identify overdue schedules.

Request

Query parameters

Name	Type	Required	Description
status	string	No	Filter by billing schedule status. One of: "pending", "invoiced", "overdue", "cancelled"
subscription_id	integer	No	Filter schedules belonging to a specific subscription.

Responses

200 List of billing schedules

Content type application/json, array of object · RevenueBillingScheduleV1.

Field	Type	Required	Description
id	integer	No	Auto-incremented primary key.
subscription_id	integer	No	ID of the subscription this billing event belongs to.
billing_date	string (date)	No	Date on which the billing event should be invoiced.
amount	number (float)	No	Amount to invoice for this billing event.
currency	string	No	ISO 4217 currency code. Max length: 3
status	string	No	Current processing status of the billing event. One of: "pending", "invoiced", "overdue", "cancelled"
notes	string, nullable	No
created_at	string (date-time)	No

Example

[
  {
    "id": 55,
    "subscription_id": 8,
    "billing_date": "2026-05-01",
    "amount": 4000.0,
    "currency": "USD",
    "status": "pending",
    "created_at": "2026-01-01T00:00:00Z"
  }
]

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/revenue/billing-schedules" \
  -H "Accept: application/json"