> For the complete documentation index, see [llms.txt](https://docs.apiperu.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apiperu.dev/enpoints/consulta-ruc-deuda-coactiva.md).

# Consulta RUC Deuda Coactiva

### Consideraciones

* Los datos se obtienen de la consulta RUC de SUNAT.

<mark style="color:green;">`POST`</mark> `https://apiperu.dev/api/ruc-deuda-coactiva`

#### Headers

| Name          | Type   | Description      |
| ------------- | ------ | ---------------- |
| Accept        | String | application/json |
| Content-Type  | string | application/json |
| Authorization | string | Bearer \<token>  |

#### Body

| Name                                  | Type   | Description |
| ------------------------------------- | ------ | ----------- |
| ruc<mark style="color:red;">\*</mark> | String | 11 dígitos  |

{% tabs %}
{% tab title="200 " %}

```json
{
    "success": true,
    "data": [
        {
            "monto": "41964490.00",
            "periodo_tibutario": "1998 - 10",
            "fecha_inicio_cobranza": "2000-07-03",
            "entidad_asociada": "Tesoro Público"
        },
        {
            "monto": "249447870.00",
            "periodo_tibutario": "1998 - 11",
            "fecha_inicio_cobranza": "2000-07-03",
            "entidad_asociada": "Tesoro Público"
        },
        {
            "monto": "71576825.00",
            "periodo_tibutario": "1998 - 12",
            "fecha_inicio_cobranza": "1999-06-04",
            "entidad_asociada": "Tesoro Público"
        },
        {
            "monto": "121274190.00",
            "periodo_tibutario": "1999 - 01",
            "fecha_inicio_cobranza": "2000-07-03",
            "entidad_asociada": "Tesoro Público"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Ejemplos de uso

{% tabs %}
{% tab title="PHP" %}

```php
    $params = json_encode(['ruc' => 'INGRESAR_NUMERO_RUC_AQUI']);
    $curl = curl_init();
    curl_setopt_array($curl, [
        CURLOPT_URL => "https://apiperu.dev/api/ruc_deuda_coactiva",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => "POST",
        CURLOPT_SSL_VERIFYPEER => false,
        CURLOPT_POSTFIELDS => $params,        
        CURLOPT_HTTPHEADER => [
            'Accept: application/json',
            'Content-Type: application/json',
            'Authorization: Bearer INGRESAR_TOKEN_AQUI'
        ],
    ]);
    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);
    if ($err) {
        echo "cURL Error #:" . $err;
    } else {
        echo $response;
    }
```

{% endtab %}
{% endtabs %}