---
title: "Listar Planos"
method: GET
path: "/plans"
---

# Listar Planos

`GET /plans`

Retorna uma lista com todos os planos da sua conta, ordenada pela data de criação, exibindo primeiro o plano criado mais recentemente. <br><br> :warning: **Importante:** O parâmetro `totalItems` retornado após a consulta indica a quantidade total de planos cadastrados. No entanto, ele somente é incluído na resposta quando uma **query** é fornecida. </br></br>

## Query parameters

- `limit` integer
- `start` integer
- `query` string
- `updated_since` string, date

## Response `200`

200

- object
  - `items` object[]
    - `id` string
    - `name` string
    - `identifier` string
    - `interval` integer
    - `interval_type` string
    - `created_at` string
    - `updated_at` string
    - `prices` object[]
      - `id` string
      - `currency` string
      - `value_cents` integer
      - `created_at` string
      - `updated_at` string
    - `features` object[]
      - `id` string
      - `name` string
      - `identifier` string
      - `value` integer
      - `important` unknown
      - `position` integer
      - `created_at` string
      - `updated_at` string
    - `payable_with` string[]
    - `max_cycles` integer
    - `billing_days` integer
    - `invoice_max_installments` unknown
  - `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)