墨西哥实时数据综合 API 墨西哥实时数据综合 APIGET 查询 IMSS 社保记录

查询 IMSS 社保记录

GET/imss/query_by_curp-20%0.12 USDT/次0.096 USDT/次

免费计费说明：发生异常时不收取费用。
空结果计费说明：该接口每天最多提供 10 次免费空结果查询。
空结果定义：服务器查询结果为空，未找到任何数据。

通过 CURP 或 NSS 查询墨西哥 IMSS 社会保障记录。【维护中，暂不可用】

以下为完整的合成示例数据。请使用您有权查询的数据进行在线测试；在线测试显示接口实际返回结果。

开始使用这个接口

  1. 注册账号，或使用已有账号。
  2. 在「账号 → 安全」中复制 API Token。
  3. 在「在线测试」中输入 Token 和您有权查询的原始数据。脱敏示例仅用于说明格式，实际调用时须替换。

在线测试受账号测试额度和网关规则约束。正式调用前，请确认接口单价和可用余额。 查看余额与充值

阅读快速接入指南

请求头参数

名称类型是否必填描述
X-Api-Tokenstring必填您的平台 API 令牌

参数

名称位置类型是否必填示例描述
curpquerystring必填TEST900101HDFABC0118-character CURP code

响应 200JSON

{
  "data": [
    {
      "nss": "00000000000",
      "curp": "TEST900101HDFABC01",
      "lastNamePaternal": "SAMPLE USER",
      "lastNameMaternal": "SAMPLE USER",
      "firstName": "SAMPLE USER",
      "gender": "SAMPLE VALUE",
      "genderCode": "2",
      "employmentRecords": [
        {
          "employerRegistration": "Y6084479",
          "modality": "10",
          "employerRFC": "XAXX010101000",
          "employerName": "SAMPLE ORGANIZATION",
          "stateName": "SAMPLE ORGANIZATION",
          "stateCode": "9",
          "dailyBaseSalary": "$1,530.26",
          "contributionDays": "28"
        }
      ]
    }
  ],
  "status": 200,
  "message": "Found",
  "success": true
}

数据来源

记录持有方
IMSS — Instituto Mexicano del Seguro Social 官方站点
数据类别
社会保险登记与 NSS
国家
墨西哥 · 公共机构

API Pull 不持有该记录的自有副本。每次调用都转发给上述来源，并把返回内容原样传回；准确性与可用性取决于该来源。

全部数据来源与留存说明 →

速率限制与免费额度

每秒请求数上限
10
每日免费空结果次数
10

未命中记录的调用在此额度内不计费。超出后，空结果按单价计费。

扣费发生在调用当时。余额不足时网关返回 402，且不会发起调用。

错误码

以下是生产环境实际观测到的状态码及其处理方式。未列出的状态码尚未出现过。

状态码含义与处理方式
200请求已到达上游并有响应返回。其中包含“查无记录”的情形，因此要看载荷内容，不能只看状态码。
402预付余额不足以支付本次调用。调用未发起，也未扣费。充值后重试。
504上游未在时限内响应。请稍后重试；对慢速登记机构而言这是正常的失败形态。
404路由不存在，或该接口已下线。
401API token 缺失或无效。

使用条件

本接口返回的是由国家登记机构或机构持有的、关于可识别个人的个人数据。你必须对查询的每一个标识符具备合法依据，不得遍历标识符区间，也不得将结果作为对他人作出不利决定的唯一依据。

合法依据（服务条款第 3 条）·完整使用条件