List subscriptions

GET/revenue/subscriptions

Returns all active and inactive subscriptions for the tenant. Subscriptions represent a customer's recurring product/service commitment, linked to a contract and a price book. Use to populate the subscription management dashboard or feed renewal forecasting.

Request

Query parameters

Name	Type	Required	Description
status	string	No	Filter subscriptions by lifecycle status. One of: "trial", "active", "paused", "cancelled", "expired"
contract_id	integer	No	Filter subscriptions linked to a specific contract.

Responses

200 List of subscriptions

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

Field	Type	Required	Description
id	integer	No
name	string	No	Descriptive name for the subscription.
status	string	No	One of: "trial", "active", "paused", "cancelled", "expired"
contract_id	integer, nullable	No	ID of the governing revenue contract.
price_book_id	integer, nullable	No	ID of the price book used to price this subscription.
customer_id	integer, nullable	No
start_date	string (date)	No
end_date	string (date), nullable	No
monthly_value	number (float)	No	Monthly recurring revenue value of this subscription.
currency	string	No	Max length: 3
seats	integer, nullable	No	Number of licensed seats (if seat-based pricing).
next_billing_date	string (date), nullable	No
created_at	string (date-time)	No

Example

[
  {
    "id": 8,
    "name": "Acme Corp — Enterprise Plan",
    "status": "active",
    "contract_id": 12,
    "price_book_id": 3,
    "start_date": "2026-01-01",
    "next_billing_date": "2026-05-01",
    "monthly_value": 4000.0,
    "currency": "USD"
  }
]

Example request

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