Skip to main content
GET
/
subscriptions
curl --request GET \
     --url https://api.tryaqueduct.com/v1/subscriptions \
     --header 'Accept: application/json' \
     --header 'Authorization: null'

[
  {
    "id": "sub_01FSSVRVGQ7GGB13815DE3F518",
    "name": "Monthly gold plan",
    "accountOwnerId": "<string>",
    "createdAt": "2022-01-15T15:53:00.000Z",
    "endDate": "2023-01-15T15:53:00.000Z",
    "productId": "prod_12PSSMRLGQ7MMQ13565DE3F557",
    "billingFrequency": "monthly",
    "firstBillingDate": "2022-03-15T15:53:00.000Z",
    "priceModelId": "<string>",
    "status": "<string>"
  }
]
curl --request GET \
     --url https://api.tryaqueduct.com/v1/subscriptions \
     --header 'Accept: application/json' \
     --header 'Authorization: null'

Authorizations

​
Authorization
string
header
required

Response

200 - application/json

Returns a list of all your subscriptions and recurring billings

​
id
string

A unique identifier for the object

Example:

"sub_01FSSVRVGQ7GGB13815DE3F518"

​
name
string

The subscription's name. Meant to be displayable to your customers.

Example:

"Monthly gold plan"

​
accountOwnerId
string

Id of the account owner associated with this subscription

​
createdAt
string<date>

Time at which the object was created.

Example:

"2022-01-15T15:53:00.000Z"

​
endDate
string<date>

Time at which the subscription ended or is scheduled to end.

Example:

"2023-01-15T15:53:00.000Z"

​
productId
string

Id of the product this subscription provides access to

Example:

"prod_12PSSMRLGQ7MMQ13565DE3F557"

​
billingFrequency
string

The frequency at which this subscription is billed. Values include once, monthly, annually

Example:

"monthly"

​
firstBillingDate
string<date>

The date of the first full invoice and anchors subsequent invoices on the the day of the month.

For example, a $30 dollar monthly recurring bill that is sent in the middle of April with an billing cycle anchor of May 1st would result in an invoice created immediately for $15 and then another $30 invoice sent out on May 1st.

Example:

"2022-03-15T15:53:00.000Z"

​
priceModelId
string

Id of the price model associated with this subscription

​
status
string

The status of this subscription. Values include ended, and active.