---
title: "Validar Linha Digitável de um Boleto"
method: POST
path: "/payment_requests/validate"
---

# Validar Linha Digitável de um Boleto

`POST /payment_requests/validate`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/payment_requests/validate`
- Auth: API key in query parameter `api_token`

Utilize o `live_api_token` da subconta ou conta mestre.

Valida se a linha digitavel de um boleto é valida. É importante se atentar ao parâmetro *"details"* onde será informado se o boleto esta em aberto ou baixado na CIP/Nuclea, Exemplo:  Boletos pagos, cancelados ou expirados será retornado como  "Retorno CIP  01 Boleto já baixado",

## Request body

- object
  - `barcode` string, required: Código de barras do pagamento
  - `detailed` boolean, required: Detalhes do boleto, deverá ser enviado como "true"

## Response `200`

200

- object
  - `message` string

---

[API](https://skmtc.dev/iugu/apis/baas.md) - [All operations](https://skmtc.dev/iugu/apis/baas/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/baas/revisions/36bf4590d03a?raw)