> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisar Contratos

> Serviço destinado a consultar contratos de serviços recorrentes.

## Endpoint

```
POST https://api.tiny.com.br/api2/contratos.pesquisa.php
```

## Parâmetros

| Parâmetro     | Tipo   | Ocorrência  | Descrição                                 |
| ------------- | ------ | ----------- | ----------------------------------------- |
| token         | string | obrigatório | Chave gerada para identificar sua empresa |
| formato       | string | obrigatório | Formato do retorno (json)                 |
| numero        | string | opcional    | Número do contrato (1)                    |
| nome\_cliente | string | opcional    | Nome do cliente (1)                       |
| situacao      | string | opcional    | Situação: ativo, cancelado, suspenso (1)  |
| pagina        | int    | opcional    | Número da página (padrão: 1)              |

> (1) Ao menos um parâmetro de pesquisa deve ser informado.

## Exemplo de chamada

```bash theme={null}
curl -X POST https://api.tiny.com.br/api2/contratos.pesquisa.php \
  -d "token=SEU_TOKEN&formato=json&situacao=ativo"
```