Skip to main content
GET
/
api
/
external
/
v2
/
billing_subscriptions
/
{id}
Get a billing subscription
curl --request GET \
  --url https://app.pennylane.com/api/external/v2/billing_subscriptions/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 42,
  "next_occurrence": "2023-01-01",
  "prev_occurrence": "2023-01-01",
  "stopped_at": "2023-08-30T10:08:08.146343Z",
  "start": "2023-01-01",
  "finish": "2023-12-31",
  "status": "draft",
  "mode": "awaiting_validation",
  "activated_at": "2023-08-30T10:08:08.146343Z",
  "payment_conditions": "upon_receipt",
  "payment_method": "offline",
  "email_settings": {
    "recipients": [
      "[email protected]"
    ],
    "billing_email_template": {
      "id": 123,
      "label": "<string>"
    }
  },
  "recurring_rule": {
    "day_of_month": [
      123
    ],
    "month_of_year": [
      123
    ],
    "week_start": 123,
    "day": [
      123
    ],
    "rule_type": "monthly",
    "interval": 123,
    "count": 12,
    "until": "<string>"
  },
  "customer": {
    "id": 42,
    "url": "https://app.pennylane.com/api/external/v2/customers/42"
  },
  "customer_invoice_data": {
    "label": "Demo label",
    "currency": "EUR",
    "amount": "230.32",
    "currency_amount": "230.32",
    "currency_amount_before_tax": "196.32",
    "exchange_rate": "1.0",
    "currency_tax": "34.0",
    "language": "fr_FR",
    "customer_invoice_template": {
      "id": 123
    },
    "discount": {
      "type": "absolute",
      "value": "25"
    },
    "pdf_invoice_free_text": "Thanks for paying this invoice",
    "pdf_invoice_subject": "Invoice subject",
    "pdf_description": "Invoice description",
    "special_mention": "Additional details",
    "invoice_line_sections": {
      "url": "https://app.pennylane.com/api/external/v2/billing_subscriptions/42/invoice_line_sections"
    },
    "invoice_lines": {
      "url": "https://app.pennylane.com/api/external/v2/billing_subscriptions/42/invoice_lines"
    }
  },
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
id
integer
required

The ID of the billing subscription to retrieve

Example:

42

Response

Returns the requested billing subscription

​
id
integer
required

Billing subscription identifier

Example:

42

​
next_occurrence
string<date> | null
required

The date for the next subscription renewal

Example:

"2023-01-01"

​
prev_occurrence
string<date> | null
required

The date of the previous subscription renewal

Example:

"2023-01-01"

​
stopped_at
string<date-time> | null
required

The exact timestamp when the subscription was terminated

Example:

"2023-08-30T10:08:08.146343Z"

​
start
string<date>
required

The subscription start date

Example:

"2023-01-01"

​
finish
string<date> | null
required

The date for when the subscription will end

Example:

"2023-12-31"

​
status
enum<string>
required
Available options:
draft,
stopped,
finished,
pending,
not_started,
in_progress
​
mode
enum<string>
required
  • awaiting_validation: generated invoices will be in draft
  • finalized: generated invoices will be finalized
  • email: generated invoices will be finalized and sent by email to the recipients configured on the subscription
Available options:
awaiting_validation,
finalized,
email
​
activated_at
string<date-time> | null
required

The exact timestamp for when the subscription was activated

Example:

"2023-08-30T10:08:08.146343Z"

​
payment_conditions
required
Available options:
upon_receipt,
7_days,
15_days,
30_days,
30_days_end_of_month,
45_days,
45_days_end_of_month,
60_days
​
payment_method
enum<string>
required

Payment method offline means the subscription is not linked to a payment method gocardless_direct-debit means at each new occurrence the client will be automatically debited thanks to GoCardless. To do so, you need a GoCardless account properly configured.

Available options:
offline,
gocardless_direct_debit
​
email_settings
object | null
required
​
recurring_rule
object
required
​
customer
object | null
required
​
customer_invoice_data
object
required
​
created_at
string<date-time>
required

The time the subscription has been created

Example:

"2023-08-30T10:08:08.146343Z"

​
updated_at
string<date-time>
required

The last time the subscription has been updated

Example:

"2023-08-30T10:08:08.146343Z"

⌘I