# Listar setores

Lista os códigos aceitos no campo sector; exige chave e não consome franquia.

Versão HTML: https://kind-coast-062131010.2.azurestaticapps.net/referencia/list-sectors/

`GET /v1/enums/sectors`

Base URL: `https://app-web-hmg-01-api-gettax-hmg-dvawffg9g9cpcef3.brazilsouth-01.azurewebsites.net` (homologação).

Autenticação: header `Authorization: Bearer <sua chave>`. [Como obter a chave](https://kind-coast-062131010.2.azurestaticapps.net/guias/autenticacao.md)

Devolve os códigos aceitos no campo `sector` da [consulta unitária](https://kind-coast-062131010.2.azurestaticapps.net/referencia/resolve-classification.md) e do [lote](https://kind-coast-062131010.2.azurestaticapps.net/referencia/resolve-classification-batch.md). O significado de cada setor e o efeito dele no resultado estão em [Dados da consulta](https://kind-coast-062131010.2.azurestaticapps.net/guias/dados-da-consulta.md#setor).

Exige chave de API, como toda rota em `/v1/`, e não consome franquia. Por isso é a forma recomendada de validar uma chave nova e de checar a saúde da integração.

## Exemplo

`$GETTAX_URL` é a base URL acima e `$GETTAX_KEY` a sua chave de API.

```shell
curl -sS "$GETTAX_URL/v1/enums/sectors" \
  -H "Authorization: Bearer $GETTAX_KEY"
```

## Respostas

### 200 · Lista de setores.

Campos:

- `sectors` (array<string>, obrigatório) — Códigos de setor aceitos hoje. A lista pode crescer: leia daqui em vez de fixá-la no código.

Exemplo:

```json
{
  "sectors": [
    "VAREJO_GERAL",
    "BAR_RESTAURANTE",
    "PRODUTOR_RURAL",
    "GOVERNO",
    "ATACADO",
    "ZONA_FRANCA"
  ]
}
```

### 401 · Chave ausente, malformada, inexistente, revogada ou de cliente desativado.

Campos:

- `error` (string, obrigatório) — Código do erro, sem mensagem detalhada. Ver [Erros e novas tentativas](https://kind-coast-062131010.2.azurestaticapps.net/guias/erros.md). Valores: `INVALID_API_KEY`.

Exemplo:

```json
{
  "error": "INVALID_API_KEY"
}
```

### 500 · Erro inesperado. Repita com backoff exponencial.

Campos:

- `error` (string, obrigatório) — Código do erro, sem mensagem detalhada. Ver [Erros e novas tentativas](https://kind-coast-062131010.2.azurestaticapps.net/guias/erros.md). Valores: `INTERNAL_ERROR`.

Exemplo:

```json
{
  "error": "INTERNAL_ERROR"
}
```

### 503 · Serviço temporariamente indisponível. Repita com backoff exponencial.

Campos:

- `error` (string, obrigatório) — Código do erro, sem mensagem detalhada. Ver [Erros e novas tentativas](https://kind-coast-062131010.2.azurestaticapps.net/guias/erros.md). Valores: `SERVICE_UNAVAILABLE`.

Exemplo:

```json
{
  "error": "SERVICE_UNAVAILABLE"
}
```