istmobot
ContenidoCertificado de Registro Público

Certificado de Registro Público

POST/v1/registro-publico3 créditosComerciov0.1.0

Extrae los datos del certificado de sociedad del Registro Público.

Petición

multipart/form-data con un solo campo:

CampoTipoDescripción
filearchivoJPEG, 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.

CampoTipoDescripción
foliostring | nullFolio mercantil de la sociedad
razon_socialstring | nullNombre de la sociedad
tipo_sociedadstring | nullTipo, ej. Sociedad Anónima, S. de R.L., Fundación de Interés Privado
fecha_inscripcionstring | nullFecha de inscripción, yyyy-mm-dd
estadostring | nullEstado de la sociedad, ej. Vigente, Disuelta, Suspendida
duracionstring | nullDuración, ej. Perpetua
capitalnumber | nullCapital social en balboas (B/.)
domiciliostring | nullDomicilio de la sociedad
agente_residentestring | nullAgente residente
representante_legalstring | nullRepresentante legal
directores[]arrayDirectores o miembros de la junta directiva
directores[].nombrestringNombre completo
directores[].cargostring | nullCargo, ej. Presidente, Tesorero, Director
dignatarios[]arrayDignatarios con su cargo
dignatarios[].nombrestringNombre completo
dignatarios[].cargostring | nullCargo, ej. Presidente, Tesorero, Director
fecha_emisionstring | nullFecha de emisión del certificado, yyyy-mm-dd
numero_certificadostring | nullNú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.