> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.callix.dev.br/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.callix.dev.br/_mcp/server.

# Usando a API para consultar qualificações

Para consultar qualificações usando a API é preciso utilizar a interface do sistema para gerar um\
[token de acesso](/introducao/visao-geral#autenticação) da API.

Cumprindo esse requisito, siga os passos descritos abaixo:

## 1. Listar todas as qualificações

Este endpoint retorna todas as qualificações cadastradas no sistema.

#### Exemplo de chamada:

```bash
curl -X GET "https://sua-conta.callix.com.br/api/v1/qualifications" \
  -H "Authorization: Bearer SEU_TOKEN"
```

#### Exemplo de resposta:

```json
{
  "data": [
    {
      "id": 1,
      "type": "qualifications",
      "attributes": {
        "name": "Qualificação 1",
        "cpc": true,
        "success": true,
        "is_system_qualification": false
      }
    },
    {
      "id": 2,
      "type": "qualifications",
      "attributes": {
        "name": "Qualificação 2",
        "cpc": true,
        "success": false,
        "is_system_qualification": false
      }
    }
  ]
}
```

#### Filtros disponíveis:

Esta rota permite filtrar qualificações usando os seguintes parâmetros:

| Filtro                            | Tipo    | Descrição                                                                                         | Exemplo                                 |
| --------------------------------- | ------- | ------------------------------------------------------------------------------------------------- | --------------------------------------- |
| `filter[cpc]`                     | boolean | Retorna apenas qualificações cujo atributo `cpc` seja igual ao valor definido                     | `filter[cpc]=true`                      |
| `filter[success]`                 | boolean | Retorna apenas qualificações cujo atributo `success` seja igual ao valor definido                 | `filter[success]=true`                  |
| `filter[is_system_qualification]` | boolean | Retorna apenas qualificações cujo atributo `is_system_qualification` seja igual ao valor definido | `filter[is_system_qualification]=false` |

#### Exemplo de chamada com filtros:

```bash
curl -X GET "https://sua-conta.callix.com.br/api/v1/qualifications?filter[cpc]=true&filter[success]=true" \
  -H "Authorization: Bearer SEU_TOKEN"
```

## 2. Consultar uma qualificação específica

Este endpoint retorna informações detalhadas de uma qualificação específica usando seu ID.

#### Exemplo de chamada:

```bash
curl -X GET "https://sua-conta.callix.com.br/api/v1/qualifications/1" \
  -H "Authorization: Bearer SEU_TOKEN"
```

#### Exemplo de resposta:

```json
{
  "data": {
    "id": 1,
    "type": "qualifications",
    "attributes": {
      "name": "Qualificação 1",
      "cpc": true,
      "success": true,
      "is_system_qualification": false
    }
  }
}
```

## Atributos

| Atributo                  | Tipo    | Descrição                                                  |
| ------------------------- | ------- | ---------------------------------------------------------- |
| `name`                    | string  | Nome da qualificação                                       |
| `cpc`                     | boolean | Indica se é uma qualificação de contato com a pessoa certa |
| `success`                 | boolean | Indica se é uma qualificação de sucesso                    |
| `is_system_qualification` | boolean | Indica se é uma qualificação do sistema                    |