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

# Consulta RUC

* Los datos obtenidos se obtienen del padrón reducido de SUNAT.

## Consulta RUC

<mark style="color:blue;">`GET`</mark> `https://leenhcraft.com/api/ruc/{ruc}`

#### Headers

| Name                                 | Type   | Description                          |
| ------------------------------------ | ------ | ------------------------------------ |
| sk<mark style="color:red;">\*</mark> | String | palabra secreta                      |
| tk<mark style="color:red;">\*</mark> | String | token generado en la alta de usuario |

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

```json
{
	"success": true,
	"message": "Operación exitosa",
	"data": {
		"direccion": "AV. LOS CASTILLOS NRO. 340 URB. INDUSTRIAL SANTA ROSA",
		"direccion_completa": "AV. LOS CASTILLOS NRO. 340 URB. INDUSTRIAL SANTA ROSA, LIMA - LIMA - ATE",
		"ruc": "20512081372",
		"nombre_o_razon_social": "'NEGOCIACION KIO' SOCIEDAD ANONIMA CERRADA",
		"estado": "ACTIVO",
		"condicion": "HABIDO",
		"departamento": "LIMA",
		"provincia": "LIMA",
		"distrito": "ATE",
		"ubigeo_sunat": "150103",
		"ubigeo": [
			"15",
			"1501",
			"150103"
		],
		"es_agente_de_retencion": null,
		"anexos": []
	}
}
```

{% endtab %}
{% endtabs %}

## Ejemplo de Uso

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

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://leenhcraft.com/api/ruc/{ruc}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_SSL_VERIFYPEER => false
  CURLOPT_HTTPHEADER => [
    "sk: {...}",
    "tk: {...}"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

{% endtab %}

{% tab title="Respuesta" %}

```json
{
  "success": true,
  "message": "Operación exitosa",
  "data": {
    "numero": "0",
    "nombre_completo": null,
    "nombres": null,
    "apellido_paterno": null,
    "apellido_materno": null,
    "direccion": null,
    "direccion_completa": null,
    "departamento": null,
    "provincia": null,
    "distrito": null,
    "nombre_o_razon_social": "BUSTAMANTE FERNANDEZ LEENH ALEXANDER",
    "codigo_verificacion": "0",
    "ubigeo_reniec": null,
    "ubigeo": ["", "", ""]
  }
}
```

{% endtab %}
{% endtabs %}