ICD-10-CM Code History & Date Validity

Look up any ICD-10-CM code against the release that was in effect on a given date of service. Returns validity, billable status, the description as published that year, and what changed between releases.

原始信息汇总

数据集概述

ICD-10-CM Code History & Date Validity（由 CodeCross 提供）是一个专注于 ICD-10-CM（国际疾病分类第十次修订临床修改版）代码历史与日期有效性 的医疗数据 API。该 API 旨在解决医疗索赔中常见的“代码在历史日期是否有效”问题，避免因使用当前代码集查询历史日期而导致的错误判断。

---

核心功能

• 按日期验证代码有效性：可查询指定日期（如服务日期）下，某 ICD-10-CM 代码是否有效、是否可计费（billable），并返回当年发布的代码描述及所属发布版本。
• 代码历史查询：提供某代码在历年版本中的完整出现记录，包括各年发布的描述及版本间变化。
• 版本变更追踪：可获取特定发布版本中新增、删除或修订的代码列表。
• 描述搜索：支持在指定日期生效的版本中按关键词搜索代码描述。
• 覆盖范围检查：提供 API 当前可查询的系统、版本及日期范围，确保查询结果可靠。

---

数据来源与更新

• 数据源：ICD-10-CM 代码集由美国 CDC/NCHS 发布，属于美国政府公共领域作品。
• 更新频率：每年 10 月 更新，与 ICD-10-CM 官方发布日历同步。
• 数据来源标记：每个版本带有 provenance 字段，标记为 official（来自官方发布机构）或 mirror（第三方副本），用户可通过 /v1/coverage 查看。

---

关键特性

• 真实性保障：所有查询结果均直接来源于对应日期的官方发布文件，不进行推断、插值或猜测性映射。
• “未知”状态处理：当查询日期超出覆盖范围时，返回 unknown（HTTP 404）并附带可查询的日期范围，绝不返回虚假的“无效”结果，避免合规工具误判。
• 明确的错误响应：错误信息均以 JSON 格式返回，包含错误描述（如参数缺失、格式错误等）。

---

限制说明

• 不支持 CPT 和 HCPCS Level I 代码（受 AMA 版权保护，无法分发）。
• 目前 未包含 HCPCS Level II 代码。
• 所有端点均为 GET 请求，系统参数固定为 icd10cm。

---

端点列表

端点	方法	功能
/v1/validate	GET	验证代码在指定日期的有效性及计费状态
/v1/history	GET	返回代码在所有版本中的出现历史及描述变化
/v1/search	GET	在指定日期生效的版本中搜索代码描述
/v1/changes	GET	获取某版本中新增、删除或修订的代码
/v1/coverage	GET	查询可回答的系统、版本及日期范围（建议优先调用）

---

适用场景

该 API 特别适合医疗合规、保险索赔审核、账单校验等需要按历史日期判断代码有效性的场景，能够准确回答“该代码在当时是否有效”的问题，并提供完整的代码生命周期信息。