---
title: "Listar assuntos"
method: GET
path: "/crm/assuntos"
tags: ["CRM"]
---

# Listar assuntos

`GET /crm/assuntos`

## Request

- Base URL: `https://api.tiny.com.br/public-api/v3`
- URL: `https://api.tiny.com.br/public-api/v3/crm/assuntos`
- Auth: HTTP bearer

## Query parameters

- `situacao` 'pendente' | 'encerrado'
- `estrela` boolean
- `arquivado` boolean
- `idContato` integer
- `idPessoaContato` integer
- `nomeCliente` string
- `statusCrm` 'L' | 'P' | 'C' | 'I'
- `idEstagio` integer
- `assunto` string
- `filtrarPor` 'data-criacao' | 'data-prevista' | 'quanto-antes' | 'esperar'
- `dataInicial` string
- `dataFinal` string
- `marcadores` union
  - string[]
  - string
- `descricaoAcao` string
- `idUsuario` integer
- `idUsuarioResponsavel` integer
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `itens` CrmAssuntoResponseModel[]
    - `id` integer
    - `assunto` string
    - `cliente` CrmClienteResumoModel: 
      - `id` integer
      - `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
      - `pessoaContato` CrmPessoaContatoModel: 
        - `nome` string, nullable
        - `telefone` string, nullable
        - `email` string, nullable
        - `ramal` string, nullable
        - `departamento` 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
      - `statusCrm` 'L' | 'P' | 'C' | 'I', nullable: - L - Lead - P - Prospect - C - Cliente - I - Inativo
    - `estagio` CrmAssuntoEstagioResponseModel: 
      - `id` integer, nullable
      - `descricao` string, nullable
    - `estrela` boolean
    - `arquivado` boolean
    - `data` string, nullable
    - `dataAtualizacao` string, nullable
    - `totalAcoes` integer
    - `totalAnotacoes` integer
    - `proximaAcao` CrmProximaAcaoModel: 
      - `descricao` string
      - `tipo` 'D' | 'Q' | 'E' | 'N', nullable: - D - Data - Q - Quanto Antes - E - Esperar - N - Sem Data
      - `data` string, nullable: Data da próxima ação (apenas quando tipo = D)
  - `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.dev/olist/apis/olist-erp-api-v3.md) - [All operations](https://skmtc.dev/olist/apis/olist-erp-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/olist/apis/olist-erp-api-v3/revisions/107f8d039de2?raw)