---
title: "Retorna as cidades"
method: GET
path: "/estados/{idestado}/cidades"
tags: ["Localidades"]
---

# Retorna as cidades

`GET /estados/{idestado}/cidades`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

## Path parameters

- `idestado` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `email` string, required
- `token` string, required

## Response `200`

Cidades

- Cidades
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `cidades` CidadeResultado[]
    - `idcidade` integer
    - `idcidade_int` string
    - `nome` string
    - `capital` string

## Other responses

- `404` — Nenhum dado encontrado!
- `422` — Erro interno ao realizar ação!

---

[API](https://skmtc.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/versions/42bf5add8bf3/schema)