GET
/
api
/
external
/
v2
/
billing_subscriptions
{
  "has_more": true,
  "items": [
    {
      "activated_at": "2023-08-30T10:08:08.146343Z",
      "created_at": "2023-08-30T10:08:08.146343Z",
      "customer": {
        "id": 42,
        "url": "https://app.pennylane.com/api/external/v2/customers/42"
      },
      "customer_invoice_data": {
        "amount": "230.32",
        "currency": "EUR",
        "currency_amount": "230.32",
        "currency_amount_before_tax": "196.32",
        "currency_tax": "34.0",
        "customer_invoice_template": {
          "id": -79843164
        },
        "discount": {
          "type": "relative",
          "value": "25"
        },
        "exchange_rate": "1.0",
        "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"
        },
        "label": "Demo label",
        "language": "fr_FR",
        "pdf_description": "Invoice description",
        "pdf_invoice_free_text": "Thanks for paying this invoice",
        "pdf_invoice_subject": "Invoice subject",
        "special_mention": "Additional details"
      },
      "email_settings": {
        "billing_email_template": {
          "id": -8131296,
          "label": "labore elit laborum tempor"
        },
        "recipients": [
          "uGdWG81kAx89yM@znhewsYdqBAVRRoBuq.dbe",
          "n79LFSsh@Jvvg.qad"
        ]
      },
      "finish": "2023-12-31",
      "id": 42,
      "mode": "finalized",
      "next_occurrence": "2023-01-01",
      "payment_conditions": "45_days_end_of_month",
      "payment_method": "gocardless_direct_debit",
      "prev_occurrence": "2023-01-01",
      "recurring_rule": {
        "count": 12,
        "day": [
          73999408.46732321,
          10476668.741298229
        ],
        "day_of_month": [
          -45973560.95373892,
          34050955.98547119
        ],
        "interval": 80534322,
        "rule_type": "monthly",
        "until": "ul",
        "week_start": 28232728.026266247
      },
      "start": "2023-01-01",
      "status": "finished",
      "stopped_at": "2023-08-30T10:08:08.146343Z",
      "updated_at": "2023-08-30T10:08:08.146343Z"
    },
    {
      "activated_at": "2023-08-30T10:08:08.146343Z",
      "created_at": "2023-08-30T10:08:08.146343Z",
      "customer": {
        "id": 42,
        "url": "https://app.pennylane.com/api/external/v2/customers/42"
      },
      "customer_invoice_data": {
        "amount": "230.32",
        "currency": "EUR",
        "currency_amount": "230.32",
        "currency_amount_before_tax": "196.32",
        "currency_tax": "34.0",
        "customer_invoice_template": {
          "id": 68978762
        },
        "discount": {
          "type": "relative",
          "value": "25"
        },
        "exchange_rate": "1.0",
        "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"
        },
        "label": "Demo label",
        "language": "fr_FR",
        "pdf_description": "Invoice description",
        "pdf_invoice_free_text": "Thanks for paying this invoice",
        "pdf_invoice_subject": "Invoice subject",
        "special_mention": "Additional details"
      },
      "email_settings": {
        "billing_email_template": {
          "id": -94247457,
          "label": ""
        },
        "recipients": [
          "x0sOyyA1vxZ5@QvOnnnPEHNKsDQWYBNfxd.zyki",
          "zXf46gp9ydy5D2@SXRADZE.puls"
        ]
      },
      "finish": "2023-12-31",
      "id": 42,
      "mode": "email",
      "next_occurrence": "2023-01-01",
      "payment_conditions": "upon_receipt",
      "payment_method": "offline",
      "prev_occurrence": "2023-01-01",
      "recurring_rule": {
        "count": 12,
        "day": [
          68843424.36526188,
          36211311.423317045
        ],
        "day_of_month": [
          -27305857.068650275,
          11472664.376148283
        ],
        "interval": -82759664,
        "rule_type": "monthly",
        "until": "eu laborum",
        "week_start": -72961458.77193645
      },
      "start": "2023-01-01",
      "status": "pending",
      "stopped_at": "2023-08-30T10:08:08.146343Z",
      "updated_at": "2023-08-30T10:08:08.146343Z"
    }
  ],
  "next_cursor": "dXBkYXRlZF9hdDoxNjc0MTIzNDU2"
}

Query Parameters

​
cursor
string

Cursor for pagination. Use this to fetch the next set of results. The cursor is an opaque string returned in the previous response's metadata. Leave empty for the first request.

Example:

"dXBkYXRlZF9hdDoxNjc0MTIzNDU2"

​
limit
string

Number of items to return per request. Defaults to 20 if not specified. Must be between 1 and 100.

Example:

"20"

​
filter
string

You can choose to filter items on specific fields. Available fields and values:

  • id, start, customer_id: lt, lteq, gt, gteq, eq, not_eq, in, not_in
  • status: eq, not_eq, in, not_in
Example:

"[{\"field\": \"status\", \"operator\": \"eq\", \"value\": \"in_progress\"}]"

​
sort
string

You can choose to sort items on specific attributes Sort field may be prefixed with - for descending order. Example : id will sort by ascending order, -id will sort by descending order. Available fields : id

Example:

"id"

Response

200
application/json

Returns a list of billing subscriptions

The response is of type object.