## Portal da Transparência / Repasse de Verba
Consulta o Portal da Transparência e obtém os repasses de verba feitos para o estado ou município informado.


### Site URL
- https://portaldatransparencia.gov.br/localidades/busca/lista?termo=&letraInicial=&pagina=1&tamanhoPagina=10

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/portal-transparencia/repasse`



| Parameter   | Description                                                                                                                                                                         |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| token*      | The token that will authenticate and authorize the request.                                                                                                                         |
| ano*        | Ano                                                                                                                                                                                 |
| localidade* | Aqui deve ser informado o nome completo do <strong>Estado</strong> ou <strong>Município</strong> a ser consultado, ou alternativamente o <strong>código IBGE</strong> do Município. |
| tipo**      | Aqui deve ser informado um dos valores a seguir: <ul><li><strong>estado</strong> para consultar o Estado.</li><li><strong>municipio</strong> para consultar o Município.</li></ul>  |

> * Required parameter.

> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.


### Response examples (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "api_version_full": "2.2.9-20230712165340",
    "product": "Consultas",
    "service": "portal-transparencia/repasse",
    "parameters": {
      "ano": "2022",
      "localidade": "SAO PAULO",
      "tipo": "municipio"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.3",
    "requested_at": "2023-07-17T08:41:44.000-03:00",
    "elapsed_time_in_milliseconds": 638,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX19n24NgbIZleStqPQGojfRE7FZph7k+amP24lDJQfwOzf5XjNOoD8Q4UgUGKEmtJ9mfwdDlAeY4Ew=="
  },
  "data_count": 1,
  "data": [
    {
      "beneficios": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 2.341.127.320,00",
          "normalizado_valor": 2341127320.0,
          "beneficiados": "738.709",
          "normalizado_beneficiados": 738709.0,
          "porcentagem": "6.56%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 199.440.478,00",
          "normalizado_valor": 199440478.0,
          "beneficiados": "67.401",
          "normalizado_beneficiados": 67401.0,
          "porcentagem": "0.60%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 1.331.720,00",
          "normalizado_valor": 1331720.0,
          "beneficiados": "301",
          "normalizado_beneficiados": 301.0,
          "porcentagem": "0.00%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 3.192.300.283,85",
          "normalizado_valor": 3192300283.85,
          "beneficiados": "254.157",
          "normalizado_beneficiados": 254157.0,
          "porcentagem": "2.26%"
        }
      ],
      "contratos_firmados": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 2.166.786.769,05",
          "normalizado_valor": 2166786769.05,
          "porcentagem": "29.11%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 510.103.125,00",
          "normalizado_valor": 510103125.0,
          "porcentagem": "6.85%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 452.590.367,13",
          "normalizado_valor": 452590367.13,
          "porcentagem": "6.08%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 450.000.000,00",
          "normalizado_valor": 450000000.0,
          "porcentagem": "6.05%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 306.980.851,26",
          "normalizado_valor": 306980851.26,
          "porcentagem": "4.12%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 275.259.596,08",
          "normalizado_valor": 275259596.08,
          "porcentagem": "3.70%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 248.641.573,55",
          "normalizado_valor": 248641573.55,
          "porcentagem": "3.34%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 155.484.228,03",
          "normalizado_valor": 155484228.03,
          "porcentagem": "2.09%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 151.472.012,22",
          "normalizado_valor": 151472012.22,
          "porcentagem": "2.04%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 140.628.949,08",
          "normalizado_valor": 140628949.08,
          "porcentagem": "1.89%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 2.584.306.648,62",
          "normalizado_valor": 2584306648.62,
          "porcentagem": "34.72%"
        }
      ],
      "convenios_acordos": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 3.891.967.233,59",
          "normalizado_valor": 3891967233.59,
          "porcentagem": "11.34%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 1.002.454.178,58",
          "normalizado_valor": 1002454178.58,
          "porcentagem": "2.92%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 631.070.530,60",
          "normalizado_valor": 631070530.6,
          "porcentagem": "1.84%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 600.000.000,00",
          "normalizado_valor": 600000000.0,
          "porcentagem": "1.75%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 600.000.000,00",
          "normalizado_valor": 600000000.0,
          "porcentagem": "1.75%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 570.671.413,56",
          "normalizado_valor": 570671413.56,
          "porcentagem": "1.66%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 465.300.000,00",
          "normalizado_valor": 465300000.0,
          "porcentagem": "1.36%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 462.298.080,21",
          "normalizado_valor": 462298080.21,
          "porcentagem": "1.35%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 455.760.000,00",
          "normalizado_valor": 455760000.0,
          "porcentagem": "1.33%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 445.486.455,52",
          "normalizado_valor": 445486455.52,
          "porcentagem": "1.30%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 25.185.219.796,52",
          "normalizado_valor": 25185219796.52,
          "porcentagem": "73.40%"
        }
      ],
      "cpdc": [],
      "distribuicao": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 1.232.895.308,41",
          "normalizado_valor": 1232895308.41,
          "porcentagem": "20.42%"
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 4.803.795.805,96",
          "normalizado_valor": 4803795805.96,
          "porcentagem": "79.58%"
        }
      ],
      "favorecidos": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 1.232.895.308,41",
          "normalizado_valor": 1232895308.41,
          "porcentagem": "100.00%"
        }
      ],
      "localidade": "Exemplo de texto",
      "programas_governo": [],
      "sancoes": [],
      "transferencias_gastos": [
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 6.036.691.114,37",
          "normalizado_valor": 6036691114.37
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 3.407.899,24",
          "normalizado_valor": 3407899.24
        },
        {
          "nome": "Exemplo de Nome",
          "valor": "R$ 3.393.072.481,85",
          "normalizado_valor": 3393072481.85
        }
      ],
      "site_receipt": "https://www.exemplo.com/exemplo-de-url"
    }
  ],
  "site_receipts": [
    "https://www.exemplo.com/exemplo-de-url"
  ]
}
```


### Preview file

The preview file (`site_receipts`) in the response JSON may be **synthesized by Infosimples** using data from the source (website/app) that processed the automation if the file generated by the source is not suitable for viewing.

### Code snippets


#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/portal-transparencia/repasse'
args = {
  "ano":        "VALUE_OF_PARAMETER_ANO",
  "localidade": "VALUE_OF_PARAMETER_LOCALIDADE",
  "tipo":       "VALUE_OF_PARAMETER_TIPO",
  "token":      "WRITE_YOUR_TOKEN_HERE",
  "timeout":    "300"
}

response = requests.post(url, args)
response_json = response.json()
response.close()

if response_json['code'] == 200:
  print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
  mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
  mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
  mensagem += "; ".join(response_json['errors'])
  print(mensagem)

print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```


## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.
