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

# Listar Planos

`GET /plans`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/plans`
- Auth: API key in query parameter `api_token`

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.dev/iugu/apis/planos.md) - [All operations](https://skmtc.dev/iugu/apis/planos/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/planos/revisions/3958c27902f6?raw)