API v1
联系方式与登记地址
从个人档案查询可用的联系方式与地址,结果仅在您的账户专属面板中显示。
税务地址与分支机构
向 SII 申报的地址。有效状态以发布版本为准,并非实地核实。
包含 SII 地址;与 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
联系人 API 需要协助开通。扩展的个人与地址查询还需单独授权。
Pro · 每月 10 次联系方式与地址查询
Max · 每月 50 次联系方式与地址查询
Pro 每个 UTC 自然月包含 10 次查询,Max 包含 50 次,不结转。网站与 API 共用额度。档案查询找到邮箱、电话或地址时扣除一次额度。同月再次查询同一人不额外扣费。资料是否可用及其时效取决于来源。
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"}'仅您的账户可见,不会在档案中公开。
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 · 未找到联系方式或地址。本次查询未产生新的费用。
409 ENRICHMENT_PENDING · 429 PROVIDER_BUSY · Retry-After · 查询正在进行,请稍候重试。
429 ENRICHMENT_QUOTA_EXCEEDED · 本月额度已用完,将于下个 UTC 自然月开始时重置。
401 INVALID_API_KEY · 403 SERVICE_FORBIDDEN · 联系人 API 需要协助开通。扩展的个人与地址查询还需单独授权。
404 PERSON_UNAVAILABLE · 此档案尚无可用于查询资料的有效 RUT。
503 PROVIDER_UNAVAILABLE · 查询未完成,请重试。
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