API Pública · Acceso Gratuito

Consulta de RUC Paraguay

API REST de acceso libre para consultar el padrón de contribuyentes. Sin autenticación, sin límites de uso, respuestas en JSON.

https://ruc.cardozopico.com/api.php

Introducción

Esta API expone la tabla ruc de la base de datos cardozoco_RUC. Todos los endpoints aceptan únicamente el método GET. La URL base es siempre la misma; el comportamiento cambia con el parámetro accion.

No requiere token, API key ni ningún tipo de autenticación. Las respuestas incluyen cabeceras CORS para que puedas consumir la API desde cualquier dominio o framework.

Endpoints

GET /api.php?accion=listar Listado paginado de todos los registros
ParámetroTipoDescripciónEstado
accionstringDebe ser listarREQUERIDO
paginaintegerNúmero de página (default: 1)OPCIONAL
limiteintegerRegistros por página, máx. 100 (default: 20)OPCIONAL
Ejemplo
GET /api.php?accion=listar&pagina=1&limite=20
GET /api.php?accion=buscar&ruc=… Buscar contribuyente por número de RUC exacto
ParámetroTipoDescripciónEstado
accionstringDebe ser buscarREQUERIDO
rucstringNúmero de RUC exactoREQUERIDO
Ejemplo
GET /api.php?accion=buscar&ruc=80000001-1
GET /api.php?accion=buscar&razon=… Buscar por razón social (coincidencia parcial)
ParámetroTipoDescripciónEstado
accionstringDebe ser buscarREQUERIDO
razonstringTexto parcial a buscar en la razón socialREQUERIDO
paginaintegerNúmero de página (default: 1)OPCIONAL
limiteintegerRegistros por página, máx. 100 (default: 20)OPCIONAL
Ejemplo
GET /api.php?accion=buscar&razon=CARDOZO&pagina=1&limite=20
GET /api.php?accion=info Estructura y columnas de la tabla

Retorna la estructura de la tabla ruc con los tipos de datos de cada columna. Útil para conocer los campos disponibles antes de hacer consultas.

Ejemplo
GET /api.php?accion=info

Ejemplos de código

JavaScript (fetch)

JavaScript
const ruc = '80000001-1';
const url = `https://ruc.cardozopico.com/api.php?accion=buscar&ruc=${ruc}`;

fetch(url)
  .then(res => res.json())
  .then(data => {
    if (data.status === 'ok') {
      console.log(data.data);
    }
  })
  .catch(err => console.error(err));

PHP

PHP
$ruc = '80000001-1';
$url = 'https://ruc.cardozopico.com/api.php?accion=buscar&ruc=' . urlencode($ruc);

$response = file_get_contents($url);
$data = json_decode($response, true);

if ($data['status'] === 'ok') {
    print_r($data['data']);
}

Python

Python
import requests

url = 'https://ruc.cardozopico.com/api.php'
params = {'accion': 'buscar', 'ruc': '80000001-1'}

r = requests.get(url, params=params)
data = r.json()

if data['status'] == 'ok':
    print(data['data'])

Respuesta JSON típica (buscar por RUC)

JSON Response
{
  "status": "ok",
  "data": {
    "ruc": "80000001-1",
    "razon_social": "NOMBRE CONTRIBUYENTE S.A.",
    ...
  }
}

Respuestas HTTP

200 OK 400 Bad Request 404 Not Found 500 Server Error

Todas las respuestas contienen un campo status con valores "ok", "not_found" o "error". En caso de error se incluye el campo mensaje con la descripción.

Tester en línea

Prueba la API directamente desde el navegador sin necesidad de herramientas externas.

Los resultados aparecerán aquí...