> For the complete documentation index, see [llms.txt](https://docs.consultasperu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.consultasperu.com/api-consultas/ruc.md).

# RUC

{% hint style="info" %} <mark style="color:blue;">**Búsqueda por Registro Único de Contribuyentes**</mark>
{% endhint %}

{% code title="POST" %}

```url
https://api.consultasperu.com/api/v1/query
```

{% endcode %}

### *<mark style="color:blue;">Headers</mark>*

| Name         | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

### *<mark style="color:blue;">Body</mark>*

```json
{
    "token": "tu_token_aqui",
    "type_document":"ruc",
    "document_number": "00000000000"
}
```

### *<mark style="color:blue;">Response</mark>*

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

```json
{
    "success": true,
    "message": "Successful response",
    "data": {
        "number": "00000000",
        "name": "Razon social",
        "business_line": "linea de negocio",
        "status": "ACTIVO",
        "domicile_conditions": "HABIDO",
        "ubigeo": "150108",
        "department": "LIMA",
        "province": "LIMA",
        "district": "CHORRILLOS",
        "address": "AV.ARIOSTO MATELLINI NRO. 000 INT. 002 URB.  PASEO DE LA REPUBLICA  LIMA - LIMA - CHORRILLOS",
        "date_creation": "17/12/2010",
        "date_update": "31/03/2024",
        "person_type_code": "02",
        "person_type": "PERSONA JURIDICA",
        "zone": "PASEO DE LA REPUBLICA",
        "es_buen_contribuyente": true,
        "es_agente_de_retencion": false
    }
}
```

{% endtab %}

{% tab title="404: Not Found" %}

```json
{
    "success": false,
    "message": "No data found",
    "data": null
}
```

{% endtab %}

{% tab title="401: Unauthorized" %}

```json
{
    "success": false,
    "message": "Invalid Token",
    "data": null
}
```

{% endtab %}
{% endtabs %}