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 文件 · OpenAPI 3.1

聯絡人 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 · 查詢未完成,請重試。

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