Certificado de Registro Público
Extrae los datos del certificado de sociedad del Registro Público.
Petición
multipart/form-data con un solo campo:
| Campo | Tipo | Descripción |
|---|---|---|
file | archivo | JPEG, PNG, WEBP, GIF o PDF. Máximo 10 MB. Obligatorio. |
curl
curl https://www.istmobot.com/api/v1/registro-publico \ -H "Authorization: Bearer ib_live_..." \ -F file=@documento.png
JavaScript
const form = new FormData();
form.append("file", fileBlob, "documento.png");
const res = await fetch("https://www.istmobot.com/api/v1/registro-publico", {
method: "POST",
headers: { Authorization: "Bearer ib_live_..." },
body: form,
});
const { data, meta } = await res.json();Respuesta
200 con data según la tabla y meta (request_id, credits_used, plugin_version, sandbox). Campos ausentes en el documento llegan como null.
| Campo | Tipo | Descripción |
|---|---|---|
folio | string | null | Folio mercantil de la sociedad |
razon_social | string | null | Nombre de la sociedad |
tipo_sociedad | string | null | Tipo, ej. Sociedad Anónima, S. de R.L., Fundación de Interés Privado |
fecha_inscripcion | string | null | Fecha de inscripción, yyyy-mm-dd |
estado | string | null | Estado de la sociedad, ej. Vigente, Disuelta, Suspendida |
duracion | string | null | Duración, ej. Perpetua |
capital | number | null | Capital social en balboas (B/.) |
domicilio | string | null | Domicilio de la sociedad |
agente_residente | string | null | Agente residente |
representante_legal | string | null | Representante legal |
directores[] | array | Directores o miembros de la junta directiva |
directores[].nombre | string | Nombre completo |
directores[].cargo | string | null | Cargo, ej. Presidente, Tesorero, Director |
dignatarios[] | array | Dignatarios con su cargo |
dignatarios[].nombre | string | Nombre completo |
dignatarios[].cargo | string | null | Cargo, ej. Presidente, Tesorero, Director |
fecha_emision | string | null | Fecha de emisión del certificado, yyyy-mm-dd |
numero_certificado | string | null | Número o código de verificación del certificado |
Ejemplo
{ "data": { "folio": "155612345", "razon_social": "CAFÉ ISTMO, S.A.", "tipo_sociedad": "Sociedad Anónima", "fecha_inscripcion": "2019-02-20", "estado": "Vigente", "duracion": "Perpetua", "capital": 10000, "domicilio": "Panamá, República de Panamá", "agente_residente": "Quintero & Asociados", "representante_legal": "María Elena Quintero Ríos", "directores": [ { "nombre": "María Elena Quintero Ríos", "cargo": null }, { "nombre": "Carlos Ríos Pérez", "cargo": null }, { "nombre": "Ana Gómez Díaz", "cargo": null } ], "dignatarios": [ { "nombre": "María Elena Quintero Ríos", "cargo": "Presidente" }, { "nombre": "Carlos Ríos Pérez", "cargo": "Tesorero" }, { "nombre": "Ana Gómez Díaz", "cargo": "Secretaria" } ], "fecha_emision": "2026-09-15", "numero_certificado": "RP-2026-1234567" }, "meta": { "request_id": "req_3f9c2a", "credits_used": 3, "plugin_version": "0.1.0", "sandbox": false } }
Con una key ib_test_ recibes exactamente este data con credits_used: 0 y sandbox: true.
Errores
401 key inválida · 402 sin créditos · 422 entrada inválida o extracción fallida · 429 rate limit. Formato en Errores.
istmobot