Customers
Events & Usage Metering
Invoices
Subscriptions
List Subscriptions
Copy
Ask AI
curl --request GET \
--url https://api.alguna.io/subscriptions \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"items": [
{
"id": "sub_0000000000000001",
"createdAt": "2024-01-01T12:00:00Z",
"updatedAt": "2024-01-01T12:00:00Z",
"organizationId": "org_0000000000000001",
"name": "Enterprise Plan - 2024",
"accountId": "acc_0000000000000001",
"purchaseOrderNumber": "PO-12345",
"description": "Annual enterprise subscription",
"trialPeriodDays": 30,
"additionalTerms": "Custom terms for this enterprise client",
"termsOfServiceLinks": [
{
"title": "Terms of Service",
"url": "https://example.com/terms"
},
{
"title": "Privacy Policy",
"url": "https://example.com/privacy"
}
],
"termsOfServiceFiles": [
{
"title": "MSA Agreement",
"fileURL": "https://example.com/files/msa.pdf"
}
],
"minimumSpend": {
"amount": "10000.00",
"period": "month"
},
"maximumSpend": {
"amount": "50000.00",
"period": "month"
},
"contractStartDate": "2024-01-01T00:00:00Z",
"contractEndDate": "2024-12-31T23:59:59Z",
"contractDuration": 12,
"contractPeriodType": "fixed",
"discount": {
"discountType": "percentage",
"amount": "10.00",
"durationType": "fixed",
"durationValue": 12,
"durationUnit": "months"
},
"currency": "USD",
"sourceCurrency": "USD",
"conversionRate": 1,
"conversionRateDate": "2024-01-01T00:00:00Z",
"status": "draft",
"quoteTemplateId": "qt_0000000000000001",
"signerName": "John Doe",
"signerEmail": "[email protected]",
"signerJobTitle": "CEO",
"cancelationReason": "no_longer_required",
"cancelationReasonDescription": "We no longer have a need for this subscription",
"activatedAt": "2024-01-01T00:00:00Z",
"endedAt": "2024-12-31T23:59:59Z",
"autoIssueInvoices": true,
"autoPayInvoices": false,
"sendInvoicesToCustomer": true,
"sendReceiptsToCustomer": true,
"invoiceGenerationStartDate": "2024-01-01T00:00:00Z",
"autoRenew": true,
"renewalPeriodType": "fixed",
"renewalDuration": 12,
"renewalHistory": [],
"firstBillingDate": "2024-01-01T00:00:00Z",
"lastBillingDate": "2024-12-31T23:59:59Z",
"chargeOneoffPricesOnContractStart": true,
"hasPDF": false,
"invoicePaymentTerms": "net_30",
"invoiceMemoTemplate": "Thank you for your business with us",
"invoiceFooterText": "Please contact [email protected] with any questions",
"sendActivationEmail": true
}
],
"pageCount": 5,
"limit": 10
}
Subscriptions
List Subscriptions
Retrieve a list of all subscriptions
GET
/
subscriptions
List Subscriptions
Copy
Ask AI
curl --request GET \
--url https://api.alguna.io/subscriptions \
--header 'Authorization: Bearer <token>'Copy
Ask AI
{
"items": [
{
"id": "sub_0000000000000001",
"createdAt": "2024-01-01T12:00:00Z",
"updatedAt": "2024-01-01T12:00:00Z",
"organizationId": "org_0000000000000001",
"name": "Enterprise Plan - 2024",
"accountId": "acc_0000000000000001",
"purchaseOrderNumber": "PO-12345",
"description": "Annual enterprise subscription",
"trialPeriodDays": 30,
"additionalTerms": "Custom terms for this enterprise client",
"termsOfServiceLinks": [
{
"title": "Terms of Service",
"url": "https://example.com/terms"
},
{
"title": "Privacy Policy",
"url": "https://example.com/privacy"
}
],
"termsOfServiceFiles": [
{
"title": "MSA Agreement",
"fileURL": "https://example.com/files/msa.pdf"
}
],
"minimumSpend": {
"amount": "10000.00",
"period": "month"
},
"maximumSpend": {
"amount": "50000.00",
"period": "month"
},
"contractStartDate": "2024-01-01T00:00:00Z",
"contractEndDate": "2024-12-31T23:59:59Z",
"contractDuration": 12,
"contractPeriodType": "fixed",
"discount": {
"discountType": "percentage",
"amount": "10.00",
"durationType": "fixed",
"durationValue": 12,
"durationUnit": "months"
},
"currency": "USD",
"sourceCurrency": "USD",
"conversionRate": 1,
"conversionRateDate": "2024-01-01T00:00:00Z",
"status": "draft",
"quoteTemplateId": "qt_0000000000000001",
"signerName": "John Doe",
"signerEmail": "[email protected]",
"signerJobTitle": "CEO",
"cancelationReason": "no_longer_required",
"cancelationReasonDescription": "We no longer have a need for this subscription",
"activatedAt": "2024-01-01T00:00:00Z",
"endedAt": "2024-12-31T23:59:59Z",
"autoIssueInvoices": true,
"autoPayInvoices": false,
"sendInvoicesToCustomer": true,
"sendReceiptsToCustomer": true,
"invoiceGenerationStartDate": "2024-01-01T00:00:00Z",
"autoRenew": true,
"renewalPeriodType": "fixed",
"renewalDuration": 12,
"renewalHistory": [],
"firstBillingDate": "2024-01-01T00:00:00Z",
"lastBillingDate": "2024-12-31T23:59:59Z",
"chargeOneoffPricesOnContractStart": true,
"hasPDF": false,
"invoicePaymentTerms": "net_30",
"invoiceMemoTemplate": "Thank you for your business with us",
"invoiceFooterText": "Please contact [email protected] with any questions",
"sendActivationEmail": true
}
],
"pageCount": 5,
"limit": 10
}
Retrieves a paginated list of all subscriptions. You can filter and sort the results using query parameters.
Query Parameters
The page number for pagination (starts at 1)
The number of subscriptions to return per page
Filter criteria to apply to the subscription list
Sorting criteria for the subscription list
Response
Copy
Ask AI
{
"items": [
{
"id": "sub_0000000000000001",
"createdAt": "2024-01-01T12:00:00Z",
"updatedAt": "2024-01-01T12:00:00Z",
"organizationId": "org_0000000000000001",
"name": "Enterprise Plan - 2024",
"accountId": "acc_0000000000000001",
"purchaseOrderNumber": "PO-12345",
"description": "Annual enterprise subscription",
"trialPeriodDays": 30,
"additionalTerms": "Custom terms for this enterprise client",
"termsOfServiceLinks": [
{
"title": "Terms of Service",
"url": "https://example.com/terms"
},
{
"title": "Privacy Policy",
"url": "https://example.com/privacy"
}
],
"termsOfServiceFiles": [
{
"title": "MSA Agreement",
"fileURL": "https://example.com/files/msa.pdf"
}
],
"minimumSpend": {
"amount": "10000.00",
"period": "month"
},
"maximumSpend": {
"amount": "50000.00",
"period": "month"
},
"contractStartDate": "2024-01-01T00:00:00Z",
"contractEndDate": "2024-12-31T23:59:59Z",
"contractDuration": 12,
"contractPeriodType": "fixed",
"discount": {
"discountType": "percentage",
"amount": "10.00",
"durationType": "fixed",
"durationValue": 12,
"durationUnit": "months"
},
"currency": "USD",
"sourceCurrency": "USD",
"conversionRate": 1,
"conversionRateDate": "2024-01-01T00:00:00Z",
"status": "draft",
"quoteTemplateId": "qt_0000000000000001",
"signerName": "John Doe",
"signerEmail": "[email protected]",
"signerJobTitle": "CEO",
"cancelationReason": "no_longer_required",
"cancelationReasonDescription": "We no longer have a need for this subscription",
"activatedAt": "2024-01-01T00:00:00Z",
"endedAt": "2024-12-31T23:59:59Z",
"autoIssueInvoices": true,
"autoPayInvoices": false,
"sendInvoicesToCustomer": true,
"sendReceiptsToCustomer": true,
"invoiceGenerationStartDate": "2024-01-01T00:00:00Z",
"autoRenew": true,
"renewalPeriodType": "fixed",
"renewalDuration": 12,
"renewalHistory": [],
"firstBillingDate": "2024-01-01T00:00:00Z",
"lastBillingDate": "2024-12-31T23:59:59Z",
"chargeOneoffPricesOnContractStart": true,
"hasPDF": false,
"invoicePaymentTerms": "net_30",
"invoiceMemoTemplate": "Thank you for your business with us",
"invoiceFooterText": "Please contact [email protected] with any questions",
"sendActivationEmail": true
}
],
"pageCount": 5,
"limit": 10
}
List of subscription objects
Show Subscription Object
Show Subscription Object
Unique identifier for the subscription
When the subscription was created in ISO 8601 format
When the subscription was last updated in ISO 8601 format
The organization ID that owns this subscription
The name of the subscription, e.g., "Enterprise Plan - 2024"
The customer account ID associated with this subscription. This is typically
an Alguna customer ID
The purchase order number provided by the customer for this subscription
A brief description of the subscription, such as "Annual enterprise
subscription"
Number of trial days before billing begins
Any additional contract terms specific to this subscription
When the contract begins in ISO 8601 format
When the contract ends in ISO 8601 format. Only set if contractPeriodType is
fixed
The duration of the contract in the units specified by contractPeriodType
The period type for the contract. Possible values:
monthly_rolling, fixedDiscount applied to the subscription
Show Discount
Show Discount
The type of discount. Possible values:
percentage, fixedThe amount of the discount - for percentage discounts, this is a
percentage (e.g., "10.00" for 10%)
How long the discount applies. Possible values:
monthly_rolling, fixedThe duration value, required if durationType is fixed
The unit of the duration. Possible values:
days, weeks, months,
yearsWhen the discount ends (deprecated, use calculated value)
The currency for the subscription (e.g., "USD")
The original currency if the subscription was converted from another currency
The rate used for currency conversion, if applicable
When the conversion rate was determined
Current status of the subscription. Possible values:
draft, sent,
accepted, active, canceledID of the quote template used, if applicable
Name of the person who signed the subscription
Email of the person who signed the subscription
Job title of the person who signed the subscription
Reason for cancellation if the subscription was canceled. Possible values:
no_longer_required, moving_provider, pricing, support, features,
otherAdditional details about the cancellation reason
When the subscription was activated
When the subscription ended
Whether invoices are automatically issued for this subscription
Whether invoices are automatically paid for this subscription
Whether invoices are sent to the customer
Whether receipts are sent to the customer
When invoice generation begins in ISO 8601 format. This can differ from the
contract start date
Whether the subscription automatically renews
The period type for renewals. Possible values:
monthly_rolling, fixedThe duration for renewals if renewalPeriodType is fixed
History of subscription renewals, with details about each renewal event
The initial billing date in ISO 8601 format
The most recent billing date in ISO 8601 format
Whether one-off prices are charged at contract start rather than on the first
billing date
Whether the subscription has a generated PDF document
Payment terms for invoices. Possible values:
on_issue, net_7, net_15,
net_30, net_60, net_90, indefiniteTemplate for invoice memos
Text displayed in the footer of invoices for this subscription
Whether an activation email is sent when the subscription is activated
Total number of pages available
Number of items per page
Assistant
Responses are generated using AI and may contain mistakes.