---
title: "GET /user/{userID}/billing-contract-subscription"
method: GET
path: "/user/{userID}/billing-contract-subscription"
tags: ["billing-contract-subscription"]
---

# GET /user/{userID}/billing-contract-subscription

`GET /user/{userID}/billing-contract-subscription`

Get all subscription billing contract for the authenticated user.

## Path parameters

- `userID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Response `200`

Show the subscription billing contract for the authenticated user.

- BillingContractSubscriptionListing[]
  - `id` integer — The id of the billing contract.
  - `created` string — The timestamp when the billing contract was made.
  - `updated` string — The timestamp when the billing contract was last updated.
  - `contract_date_start` string — The date from when the billing contract is valid.
  - `contract_date_end` string — The date until when the billing contract is valid.
  - `contract_version` integer — The version of the billing contract.
  - `subscription_type` string — The subscription type of the user. Can be one of PERSON_SUPER_LIGHT_V1, PERSON_LIGHT_V1, PERSON_MORE_V1, PERSON_FREE_V1, PERSON_PREMIUM_V1, COMPANY_V1, or COMPANY_V2.
  - `subscription_type_downgrade` string — The subscription type the user will have after a subscription downgrade. Will be null if downgrading is not possible.
  - `status` string — The subscription status.
  - `sub_status` string — The subscription substatus.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/revisions/369477c7bd26/schema)