# Baixar convênios

> ## Método POST
>
> <http://api.milksrota.com.br/farmer/retaguarda/readConvenio>

## Requisição

### Dados da requisição

```javascript
{
    "conta_id": "DDDDD",
    "token": "XXXX-XXXX-XXXX-XXXX",
    "doc": "99.999.999/9999-99"
}
```

{% hint style="info" %}
**conta\_id**: Deve ser informado o ID da conta que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**token**: Deve ser informado o Token da conta, que você encontra na tela ***"Sua conta"*** no menu principal no painel do Milk's Rota.

**doc :** Deve ser informado o CNPJ cadastrado para a conta. Pode ser obtido na tela ***"Sua conta"*** no menu principal do painel do Milk's Rota.
{% endhint %}

## Resposta

### 200: Registros localizados

```javascript
{
    "success": true,
    "message": "OK",
    "data": [
        {
            "id": "1120",
            "conta_id": "591973",         
            "codigo": "001",
            "convenio": "João das Couves",
            "tipo": "F",
            "deleted": 0, // ativa o registro
            "doc": "090.123.231-20",
            "numero": "123",
            "logradouro": "Rua das Canárias",
            "bairro": "Laranjeiras",
            "cidade": "Alagoana",
            "uf": "Minas Gerais",
            "cep": "31400-000",
            "email": "joao.couves@gmail.com",
            "telefone": "(37) 99912-4949"
            "ativo": "1",            
            "dt_criacao": "2019-06-19 10:29:26",
            "dt_atualizacao": "2019-06-19 10:29:26",
            "dt_excusao": null,
        },
        {
            "id": "1121",
            "conta_id": "591973",         
            "codigo": "002",
            "nome": "Posto de combustível Juá",
            "tipo": "J",
            "deleted": 1, // desativa o registro         
            "doc": "10.290.123.0001/10",
            "numero": "98",
            "logradouro": "Rua D",
            "bairro": "Martins Godoy",
            "cidade": "Santa Bárbara",
            "uf": "Minas Gerais",
            "cep": "31560-000",
            "email": null,
            "telefone": "(37) 99912-4949"         
            "dt_criacao": "2019-06-19 10:29:26",
            "dt_atualizacao": "2019-06-19 10:29:26",
            "dt_excusao": null,
        },
  ],
    "monitor.time": 0.21102690696716
}       
```

{% hint style="success" %}
Os registros de convênio foram recuperados na plataforma Milk's e retornados com sucesso.
{% endhint %}

### 400: Conta não localizada

```javascript
{    
    "success": false,
    "message": "Conta não localizada",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**O que isso significa?** Significa que o ID da conta não foi localizado na Plataforma Milk's.
{% endhint %}

### 403: Token inválido

```javascript
{
    "success": false,
    "message": "Token inválido",
    "data": [],
    "monitor.time": 2.14737200737 // Tempo de execução
}
```

{% hint style="danger" %}
**O que isso significa?** Significa que o token informado na requisição não corresponde ao token cadastrado para a conta.
{% endhint %}