---
title: "Subscriptions (Teamleader Focus)"
description: "Subscriptions"
language: en
source_language: en
translation_state: complete
canonical: https://documentation.invantive.eu/en/datamodels/teamleader/Teamleader.V2.Subscriptions
original: https://documentation.invantive.eu/en/datamodels/teamleader/Teamleader.V2.Subscriptions
updated: 2026-11-01T17:45:29Z
license: https://documentation.invantive.eu/en/
---

# Subscriptions: Teamleader Focus Subscriptions

`read only` `REST`

- Catalog: `Teamleader`
- Schema: `V2`
- Primary Keys: `id`
- Label: Subscriptions

Can only retrieve data.

## API Source

- Endpoint: `subscriptions.list`

## Performance Characteristics

| Characteristic | Value |
|---|---:|
| Average access latency (ms) | 39 |

The result can be cached on the client.

## Parameters

| Name | Data Type | Required | Default | Documentation |
|---|---|:---:|---|---|
| `deal_id` | `` | [ ] |  | Filter on subscriptions created from a deal. |
| `department_id` | `` | [ ] |  | Filter on subscriptions of a specific department (company entity). |
| `invoice_id` | `` | [ ] |  | Find subscriptions that generated the given invoice. |

## Table Columns

The columns of the table `Subscriptions` are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

| Name | Data Type | Label | Required | Marks | Documentation |
|---|---|---|:---:|---|---|
| `billing_cycle_days_in_advance` | `varchar2` | Billing Cycle Days in Advance | [ ] | filters on the platform, writable, `billing_cycle.days_in_advance` |  |
| `billing_cycle_periodicity_period` | `varchar2` | Billing Cycle Periodicity Period | [ ] | filters on the platform, writable, `billing_cycle.periodicity.period` |  |
| `billing_cycle_periodicity_unit` | `varchar2` | Billing Cycle Periodicity Unit | [ ] | filters on the platform, writable, `billing_cycle.periodicity.unit` |  |
| `c_abonnementtext` | `varchar2` | itgen_teamleader_c_abonnementtext | [ ] | filters on the platform, writable |  |
| `department_id` | `varchar2` | Department ID | [ ] | filters on the platform, writable, `department.id` |  |
| `ends_on` | `datetime` | Ends On | [ ] | filters on the platform, writable |  |
| `id` | `varchar2` | ID | [x] | filters on the platform, writable |  |
| `invoicee_customer_id` | `varchar2` | Invoicee Customer ID | [ ] | filters on the platform, writable, `invoicee.customer.id` |  |
| `invoicee_customer_type` | `varchar2` | Invoicee Customer Type | [ ] | filters on the platform, writable, `invoicee.customer.type` |  |
| `invoicee_for_attention_of_contact_id` | `varchar2` | Invoice for Attention of Contact ID | [ ] | filters on the platform, writable, `invoicee.for_attention_of.contact.id` |  |
| `invoicee_for_attention_of_contact_type` | `varchar2` | Invoice for Attention of Contact Type | [ ] | filters on the platform, writable, `invoicee.for_attention_of.contact.type` |  |
| `invoicee_for_attention_of_name` | `varchar2` | Invoice for Attention of Name | [ ] | filters on the platform, writable, `invoicee.for_attention_of.name` |  |
| `invoicee_name` | `varchar2` | Invoicee Name | [ ] | filters on the platform, writable, `invoicee.name` |  |
| `invoicee_vat_number` | `varchar2` | Invoicee VAT Number | [ ] | filters on the platform, writable, `invoicee.vat_number` |  |
| `next_renewal_date` | `datetime` | Next Renewal Date | [ ] | filters on the platform, writable |  |
| `note` | `varchar2` | Note | [ ] | filters on the platform, writable | Uses Markdown formatting. |
| `project_id` | `varchar2` | Project ID | [ ] | filters on the platform, writable, `project.id` |  |
| `starts_on` | `datetime` | Starts on | [ ] | filters on the platform, writable |  |
| `status` | `varchar2` | Status | [ ] | filters on the platform, writable |  |
| `title` | `varchar2` | Title | [ ] | filters on the platform, writable |  |
| `total_tax_exclusive_amount` | `decimal` | Total Amount excluding Taxes | [ ] | filters on the platform, writable, `total.tax_exclusive.amount` |  |
| `total_tax_exclusive_before_discount_amount` | `decimal` | Total Tax Exclusive before Discount Amount | [ ] | filters on the platform, writable, `total.tax_exclusive_before_discount.amount` |  |
| `total_tax_exclusive_before_discount_currency` | `varchar2` | Total Tax Exclusive before Discount Currency | [ ] | filters on the platform, writable, `total.tax_exclusive_before_discount.currency` |  |
| `total_tax_exclusive_currency` | `varchar2` | Currency of Total Amount excluding Taxes | [ ] | filters on the platform, writable, `total.tax_exclusive.currency` |  |
| `total_tax_inclusive_amount` | `decimal` | Total Amount including Taxes | [ ] | filters on the platform, writable, `total.tax_inclusive.amount` |  |
| `total_tax_inclusive_before_discount_amount` | `decimal` | Total Tax Inclusive before Discount Amount | [ ] | filters on the platform, writable, `total.tax_inclusive_before_discount.amount` |  |
| `total_tax_inclusive_before_discount_currency` | `varchar2` | Total Tax Inclusive before Discount Currency | [ ] | filters on the platform, writable, `total.tax_inclusive_before_discount.currency` |  |
| `total_tax_inclusive_currency` | `varchar2` | Currency of Total Amount including Taxes | [ ] | filters on the platform, writable, `total.tax_inclusive.currency` |  |
| `web_url` | `varchar2` | Web (URL) | [ ] | filters on the platform, writable |  |

## Keys

| Key | Column | Refers to | Kind | Description |
|---|---|---|---|---|
| `Subscriptions_invoicee_customer_id_Companies_txt` | `invoicee_customer_id` | [Companies](Teamleader.V2.Companies)`.id` | Textual | The id of a row of Companies, when invoicee_customer_type is 'company'. |
| `Subscriptions_invoicee_customer_id_Contacts_txt` | `invoicee_customer_id` | [Contacts](Teamleader.V2.Contacts)`.id` | Textual | The id of a row of Contacts, when invoicee_customer_type is 'contact'. |



## Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver:

- [Teamleader Focus](/en/release-notes/drivers?driver=teamleader-focus)

