API de Perfil Verificado

Cómo funciona

• El candidato le da su código (p. ej. VP-7K3F-9Q2M-XP), desde su CV, certificado o enlace. El código es su consentimiento: solo puede leer perfiles cuyo titular le dio el código, mientras el enlace esté activo.
• Cada consulta aparece en el registro de accesos del candidato con el nombre de su organización.
• Nunca se devuelven números de identidad, fechas de nacimiento, domicilios ni datos de contacto.

Autenticación

Envíe su clave de API en la cabecera X-API-Key. Stodacom emite las claves para cuentas de cliente -- contáctenos para obtener una. Manténgala en secreto y en el servidor; nunca la ponga en un navegador ni en una aplicación móvil.

Consultar un perfil

GET https://stodacomdesktop.com/api/v1/verified_profile?code=VP-XXXX-XXXX-XX

Parámetro	Descripción
code	Obligatorio. El código. Mayúsculas, espacios y guiones dan igual.
include_photo	Opcional, 1 para incluir la foto verificada en JPEG base64 (solo si la identidad se comparte y la foto está verificada).

curl -H "X-API-Key: YOUR_KEY" \
  "https://stodacomdesktop.com/api/v1/verified_profile?code=VP-7K3F-9Q2M-XP"

Respuesta:

{
  "success": true,
  "profile": {
    "name": "Jane Achieng",
    "name_verified": true,
    "photo_verified": true,
    "overall_status": "partially_verified",
    "verified_count": 2,
    "total_count": 3,
    "share_code": "VP-7K3F-9Q2M-XP",
    "link_expires_at": "2026-10-27T13:10:49+03:00",
    "checked_at": "2026-09-27T13:10:49+03:00",
    "check_url": "https://stodacomdesktop.com/verified_profile_check?code=VP-7K3F-9Q2M-XP",
    "items": [
      {
        "type": "identity",
        "label": "Identity",
        "status": "verified",
        "details": [{"label": "Name on ID", "value": "Jane Achieng"}],
        "verification": {
          "method": "National ID Database Check",
          "verified_at": "2026-09-13T16:33:18+03:00",
          "valid_until": "2027-09-13T16:33:18+03:00",
          "audit_id": "STV-000144"
        }
      }
    ]
  }
}

Estados

status del elemento	Significado
verified	Verificado por Stodacom y dentro de su periodo de validez.
needs_review	Estaba verificado, pero la reverificación está pendiente o en curso.
discrepancy	Nuestras comprobaciones encontraron algo que no coincide. No confíe en ello.
rejected	Revisado y no se pudo verificar.
not_verified	Nunca verificado, o la verificación ha vencido.

overall_status es uno de fully_verified, partially_verified, in_progress, issue (una discrepancia) o pending.

Consultar una empresa

Una empresa con la que trabaja le da su código (p. ej. VB-7K3F-9Q2M-XP), desde su página de enlace o su certificado. Igual que con los perfiles, el código es su consentimiento, cada consulta aparece en su registro con el nombre de su organización y las consultas se cuentan y cobran igual. Nunca se devuelven documentos, números de identidad, fechas de nacimiento ni datos de contacto de las personas.

GET https://stodacomdesktop.com/api/v1/verified_business?code=VB-XXXX-XXXX-XX

curl -H "X-API-Key: YOUR_KEY" \
  "https://stodacomdesktop.com/api/v1/verified_business?code=VB-7K3F-9Q2M-XP"

Respuesta:

{
  "success": true,
  "business": {
    "legal_name": "Kigali Fresh Produce Ltd",
    "trading_name": "KFP",
    "registration_number": "108766432",
    "country": "Rwanda",
    "legal_form": "Limited Liability Company",
    "incorporation_date": "2019-03-04",
    "registry_status": "Active / registered",
    "trust_level": "verified",
    "items": [
      {
        "item": "registration",
        "label": "Registration",
        "status": "verified",
        "verified_on": "2026-10-25",
        "valid_until": "2027-10-25",
        "audit_id": "STB-000104",
        "change_under_review_since": null
      }
    ],
    "directors": [{"name": "Aline Uwase", "role": "Managing director"}],
    "owners": [{"name": "Aline Uwase", "type": "individual", "effective_percent": 60,
                "held": "direct", "owners_not_traced": null}],
    "address": {"registered": "KG 11 Ave, Kigali", "trading": null},
    "licences": [],
    "screening": {"last_screened_on": "2026-10-26", "confirmed_matches": []},
    "share_code": "VB-7K3F-9Q2M-XP",
    "link_expires_at": "2027-01-23",
    "checked_at": "2026-10-26T09:00:00+03:00"
  }
}

Campo	Significado
trust_level	unverified (nada verificado aún), registered (registro verificado), verified (también representante, directivos y propietarios) o verified_plus (también dirección y licencias).
items[].status	verified, expired (han pasado sus 12 meses) o not_verified.
change_under_review_since	La empresa comunicó un cambio en esta fecha y se está comprobando; la verificación mostrada sigue vigente hasta entonces.
owners	Sociedades propietarias y personas que poseen en la práctica el 10 % o más, a través de las sociedades intermedias. owners_not_traced indica por qué no se rastrearon los dueños de una sociedad (por ejemplo, cotiza en bolsa).
screening	La empresa, sus directivos y propietarios se comprueban a diario frente a listas de sanciones, inhabilitaciones y personas políticamente expuestas. confirmed_matches enumera las coincidencias confirmadas por nuestro equipo, con sus indicadores.

Errores y límites

HTTP	Cuándo
400	No se indicó code.
401	Clave de API ausente, no válida o desactivada.
404	Ningún perfil ni empresa activo para ese código -- mal escrito, vencido o revocado. Trátelo como no verificado.
402	Ha agotado las consultas gratuitas del mes y su monedero prepago no cubre la siguiente. Recargue para continuar.
429	Límite de peticiones: la cuota por minuto de su clave (120 por defecto) o 120 por minuto por dirección IP.

Precios: las primeras 100 consultas correctas de cada mes son gratis, después $0.25 cada una -- de su monedero, o en su extracto mensual para cuentas facturadas. Las consultas que devuelven 404 no cuentan.

Los resultados son en vivo en el momento de la consulta; guarde checked_at con lo que almacene y vuelva a consultar antes de fiarse de un resultado antiguo.