Apizeal API
Accede a tus contactos y sus pólizas desde tus propios sistemas. Disponible para todo usuario con el plan Growth.
Quickstart
- En la app de Apizeal, ve a Integrations → API Keys y crea una key. Cópiala de inmediato — por seguridad se muestra una sola vez.
- Llama al API con tu key en el header
Authorization:
curl https://api.apizeal.com/v1/contacts?page_size=5 \
-H "Authorization: Bearer az_live_TU_KEY"
Eso es todo. La respuesta es JSON:
{
"data": [
{
"id": "1256144",
"full_name": "Juan Martinez",
"email": "juan@example.com",
"has_ssn": true,
...
}
],
"next_cursor": "djE6NQ==",
"has_more": true
}
El API devuelve exactamente lo que tu usuario ve en la app de
Apizeal — los mismos contactos, las mismas pólizas, los mismos permisos.
Qué puedes hacer en v1
Contactos
Listar y leer tus contactos, con filtros por email, teléfono, nombre y estatus.
Pólizas
Listar y leer pólizas, miembros del grupo familiar, datos de Medicare/Medicaid y estatuses.
Catálogos
Resolver ids de carriers, tipos de producto y estatuses de póliza a nombres.
v1 es de solo lectura. Operaciones de escritura y webhooks están en el roadmap.
Paginación
Los listados devuelven páginas con un next_cursor opaco. Envíalo de
vuelta para la siguiente página; cuando has_more sea false,
terminaste. El tamaño de página máximo es 100.
curl "https://api.apizeal.com/v1/policies?page_size=100&cursor=djE6MTAw" \
-H "Authorization: Bearer az_live_TU_KEY"
Convenciones
- Todos los ids son strings. No hagas aritmética con ellos.
- Fechas en
YYYY-MM-DD; timestamps en ISO 8601. - Los valores sensibles nunca se devuelven. Por ejemplo, el SSN se expone solo
como el booleano
has_ssn. - Los campos enum pueden ganar valores nuevos con el tiempo — trata los valores desconocidos como válidos.