---
title: "Listar contatos"
method: GET
path: "/contatos"
tags: ["Contatos"]
---

# Listar contatos

`GET /contatos`

## Query parameters

- `nome` string
- `codigo` string
- `situacao` 'B' | 'A' | 'I' | 'E'
- `idVendedor` integer
- `cpfCnpj` string
- `celular` string
- `dataCriacao` string
- `dataAtualizacao` string
- `orderBy` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` ListagemContatoModelResponse[]
    - `nome` string, nullable
    - `codigo` string, nullable
    - `fantasia` string, nullable
    - `tipoPessoa` 'J' | 'F' | 'E' | 'X', nullable — - J - Juridica - F - Fisica - E - Estrangeiro - X - Estrangeiro No Brasil
    - `cpfCnpj` string, nullable
    - `inscricaoEstadual` string, nullable
    - `rg` string, nullable
    - `telefone` string, nullable
    - `celular` string, nullable
    - `email` string, nullable
    - `endereco` EnderecoModel — 
      - `endereco` string, nullable
      - `numero` string, nullable
      - `complemento` string, nullable
      - `bairro` string, nullable
      - `municipio` string, nullable
      - `cep` string, nullable
      - `uf` string, nullable
      - `pais` string, nullable
    - `id` integer
    - `vendedor` VendedorResponseModel — 
      - `id` integer
      - `nome` string, nullable
    - `situacao` 'B' | 'A' | 'I' | 'E', nullable — - B - Ativo - A - Ativo Com Acesso Sistema - I - Inativo - E - Excluido
    - `statusCrm` 'L' | 'P' | 'C' | 'I', nullable — - L - Lead - P - Prospect - C - Cliente - I - Inativo
    - `dataCriacao` string, nullable
    - `dataAtualizacao` string, nullable
  - `paginacao` PaginatedResultModel — 
    - `limit` integer
    - `offset` integer
    - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/olist/apis/olist-erp-api-v3.md) · [All operations](https://skmtc.net/olist/apis/olist-erp-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olist/olist-erp-api-v3/versions/c351400bb11f/schema)