Introducción a las APIs de ECORPA

Las APIs de ECORPA te permiten consultar, generar formularios, radicar afiliaciones y extraer documentos en Colombia. Te autenticas con una API Key y trabajas por solicitud: envías un lote, recibes un IdSolicitud y consultas el resultado, o registras una URL de aviso para que ECORPA te lo envíe cuando termine.

Servicios

Servicio	Path	Scope
Consultas seguridad social	`/v2/consulta/seguridad_social`	`consultas_seguridad_social`
Consulta de antecedentes	`/v2/consulta/antecedentes`	`consulta_antecedentes`
Formularios de afiliación	`/v2/formularios/afiliacion`	`formularios_afiliacion`
Afiliaciones seguridad social	`/v2/afiliaciones/seguridad_social`	`afiliaciones_seguridad_social`
Extractor de documentos	`/v2/extractor-documentos/documento-identidad`	`extractor_documentos`

URL base

https://apis.ecorpa.com/v2

Flujo

Autenticar

Header Authorization: Bearer con ecorpa_key_… en producción o ecorpa_test_… en prueba, y el scope del servicio. La key de prueba no gasta créditos.

Crear solicitud

POST con uno o varios registros. Respuesta con IdSolicitud.

Consultar resultado

GET …/{IdSolicitud} hasta que cada ítem termine (procesado, error, etc.).

Formato de respuesta

Las respuestas van en PascalCase:

{
  "Success": true,
  "Message": "Texto legible",
  "Data": {}
}

Siguiente: Autenticación.

​Servicios

​URL base

​Flujo

​Formato de respuesta

Servicios

URL base

Flujo

Formato de respuesta