***

title: Exemplos práticos
subtitle: 'Cenários prontos para copiar, adaptar e testar'
slug: use-cases
---------------

## Consultar todas as oportunidades

```http
GET {{base_url}}/simplificav2/oportunidade
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar oportunidades abertas

Formato legível:

```http
GET {{base_url}}/simplificav2/oportunidade?q={"status":"ABERTA"}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/oportunidade?q=%7B%22status%22%3A%22ABERTA%22%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar itens de uma oportunidade

Formato legível:

```http
GET {{base_url}}/simplificav2/oportunidade_item?q={"oportunidade_id":29627}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/oportunidade_item?q=%7B%22oportunidade_id%22%3A29627%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar pessoas ativas

Formato legível:

```http
GET {{base_url}}/simplificav2/pessoa?q={"ativo":"S"}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/pessoa?q=%7B%22ativo%22%3A%22S%22%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar uma pessoa específica

Formato legível:

```http
GET {{base_url}}/simplificav2/pessoa?q={"id":162472}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/pessoa?q=%7B%22id%22%3A162472%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar atividades de uma pessoa

Formato legível:

```http
GET {{base_url}}/simplificav2/atividade?q={"pessoa_id":3285}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/atividade?q=%7B%22pessoa_id%22%3A3285%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar follow-ups pendentes

Formato legível:

```http
GET {{base_url}}/simplificav2/atividade_follow_up?q={"concluido":"N"}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/atividade_follow_up?q=%7B%22concluido%22%3A%22N%22%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar reuniões pendentes

Formato legível:

```http
GET {{base_url}}/simplificav2/reuniao?q={"status":"PENDENTE"}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/reuniao?q=%7B%22status%22%3A%22PENDENTE%22%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar receitas por período

Formato legível:

```http
GET {{base_url}}/simplificav2/receita?q={"criado_em":{"$between":[{"$date":"2026-03-01T00:00:00Z"},{"$date":"2026-03-31T23:59:59Z"}]}}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

Formato pronto para URL:

```http
GET {{base_url}}/simplificav2/receita?q=%7B%22criado_em%22%3A%7B%22%24between%22%3A%5B%7B%22%24date%22%3A%222026-03-01T00%3A00%3A00Z%22%7D%2C%7B%22%24date%22%3A%222026-03-31T23%3A59%3A59Z%22%7D%5D%7D%7D
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Consultar despesas parceladas

```http
GET {{base_url}}/simplificav2/despesa_parcelada?limit={{limit}}
Authorization: Bearer {{bearer_token}}
Accept: application/json
```

## Dica para integrações e agentes de IA

Sempre que possível:

1. leia primeiro o endpoint base;
2. identifique os campos publicados no schema;
3. só depois aplique filtros específicos;
4. trate paginação com `hasMore`, `limit` e `offset`.