API v1

Contacto y domicilios registrados

Consulta los datos de contacto y domicilios disponibles desde la ficha de una persona, en un panel privado para tu cuenta.

Domicilio tributario y sucursales

Direcciones declaradas ante el SII. La vigencia corresponde a la edición publicada, no a una verificación presencial.

Incluye domicilios SII; comparte el cupo con las consultas por RUT. Pro: 500 / Max: 1.000.

POST /api/v1/companies/addresses

curl https://ibero.center/api/v1/companies/addresses \
  -H "Authorization: Bearer $IBERO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"rut":"76.086.428-5"}'

domicilio · domiciliosVigentes · sucursales · historicas · domicilioAmbiguo · fuente

401 INVALID_API_KEY · 403 SERVICE_FORBIDDEN · 404 ADDRESS_NOT_FOUND · 429 QUOTA_EXCEEDED · 503 ADDRESS_DATA_UNAVAILABLE

Documentación de la API de domicilios · OpenAPI 3.1

La API de contactos requiere activación asistida. La consulta ampliada de personas y domicilios requiere además un permiso específico.

Pro · 10 consultas de contacto y domicilios de personas / mes

Max · 50 consultas de contacto y domicilios de personas / mes

Pro incluye 10 consultas y Max 50 por mes calendario UTC, sin acumulación. La web y la API comparten la cuota. En la ficha, se utiliza un crédito si se obtiene correo, teléfono o algún domicilio. Volver a consultar la misma persona durante el mes no tiene un nuevo cargo. La disponibilidad y vigencia dependen de la fuente.

POST /api/v1/people/enrich

curl https://ibero.center/api/v1/people/enrich \
  -H "Authorization: Bearer $IBERO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"rut":"RUT_PERSONA"}'

Solo visible para tu cuenta. No se publica en la ficha.

HTTP 200

{
  "contact": {
    "email": "contact@example.invalid",
    "phone": null,
    "enrichedAt": "2026-09-09T00:00:00.000Z"
  },
  "cached": false,
  "charged": true,
  "quota": {
    "planKey": "pro",
    "limit": 10,
    "used": 1,
    "pending": 0,
    "remaining": 9,
    "period": "2026-09-01",
    "resetsAt": "2026-10-01T00:00:00+00:00"
  }
}

NO_CONTACT_DATA · No se encontraron datos de contacto ni domicilios disponibles. Esta consulta no generó un nuevo cargo.

409 ENRICHMENT_PENDING · 429 PROVIDER_BUSY · Retry-After · Hay una consulta en curso. Espera unos segundos y vuelve a intentar.

429 ENRICHMENT_QUOTA_EXCEEDED · Has alcanzado el cupo mensual. Se renueva al comenzar el próximo mes UTC.

401 INVALID_API_KEY · 403 SERVICE_FORBIDDEN · La API de contactos requiere activación asistida. La consulta ampliada de personas y domicilios requiere además un permiso específico.

404 PERSON_UNAVAILABLE · Esta ficha todavía no dispone de un RUT válido para consultar estos datos.

503 PROVIDER_UNAVAILABLE · No pudimos completar la consulta. Inténtalo de nuevo.

OpenAPI 3.1 · JSON

POST /api/v1/people/lookup · Alta de trabajadores

Consulta por RUT para integraciones de alta autorizadas. Requiere un permiso adicional por empresa y clave; no exige que la persona exista en el directorio.

Devuelve nombres, apellidos, contacto, fecha de nacimiento, código de nacionalidad y domicilios disponibles. Los campos faltantes son null. Revisa los datos y elige el domicilio correspondiente antes de guardar.

Comparte la cuota de contactos. Una respuesta útil consume una consulta; repetir el mismo RUT durante el mes o ampliar un contacto ya consultado no consume otra.

Contrato de consulta de personas · OpenAPI 3.1