---
title: "Listar Assinaturas"
method: GET
path: "/subscriptions"
---

# Listar Assinaturas

`GET /subscriptions`

Retorna uma lista com as assinaturas geradas pela sua conta, ordenadas pela data de criação, da mais nova para a mais antiga. O campo totalItems indica a quantidade de registros retornados nesta página (igual ao tamanho de items ). Para detectar o fim da listagem, compare items.length com limit : se for menor, não há mais páginas.

## Query parameters

- `limit` integer
- `start` integer
- `created_at_from` string, date
- `created_at_to` string, date
- `query` string
- `updated_since` string, date
- `updated_until ` string, date
- `customer_id` string
- `status_filter` string
- `plan_identifier` string

## Response `200`

200

- object
  - `items` object[]
    - `id` string
    - `suspended` boolean
    - `plan_identifier` string
    - `price_cents` integer
    - `currency` string
    - `features` object
    - `customer_name` string
    - `customer_email` string
    - `cycled_at` string
    - `credits_min` integer
    - `credits_cycle` unknown
    - `payable_with` string[]
    - `ignore_due_email` boolean
    - `max_cycles` integer
    - `cycles_count` integer
    - `recent_invoices` object[]
      - `id` string
      - `due_date` string
      - `status` string
      - `total` string
      - `secure_url` string
    - `subitems` object[]
      - `id` string
      - `description` string
      - `quantity` integer
      - `price_cents` integer
      - `recurrent` boolean
      - `price` string
      - `total` string
    - `logs` object[]
      - `id` string
      - `description` string
      - `notes` string
      - `subscription_changes` string
      - `created_at` string
    - `custom_variables` object[]
    - `expires_at` string
    - `created_at` string
    - `updated_at` string
    - `customer_id` string
    - `plan_name` string
    - `customer_ref` string
    - `plan_ref` string
    - `active` boolean
    - `two_step` unknown
    - `suspend_on_invoice_expired` unknown
    - `in_trial` unknown
    - `credits` integer
    - `credits_based` boolean
  - `facets` object
    - `due` object
      - `_type` string
      - `count` integer
    - `active` object
      - `_type` string
      - `count` integer
    - `suspended` object
      - `_type` string
      - `count` integer
  - `totalItems` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)