aapc.com APIaapc.com ↗
Look up CPT, ICD-10-CM, ICD-10-PCS, and HCPCS codes with descriptions, hierarchies, and search via the AAPC Codify API. 13 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2a47e7bb-8773-4144-a7a0-01b82a6cc5ca/get_cpt_sections' \ -H 'X-API-Key: $PARSE_API_KEY'
Get top-level CPT code sections. Returns the major CPT code categories (e.g., Anesthesia, Surgery, Radiology).
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of CPT section objects each containing label, range, and url",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"url": "https://www.aapc.com/codes/cpt-codes-range/00100-01999/",
"label": "Anesthesia",
"range": "00100-01999"
},
{
"url": "https://www.aapc.com/codes/cpt-codes-range/10004-69990/",
"label": "Surgery",
"range": "10004-69990"
}
],
"status": "success"
}
}About the aapc.com API
The AAPC Codify API provides structured access to four major medical code sets across 13 endpoints, covering CPT, ICD-10-CM, ICD-10-PCS, and HCPCS Level II codes. You can browse top-level sections with get_cpt_sections, drill into leaf-level subsections, retrieve individual code details including lay terms and breadcrumbs, or run cross-code-set keyword searches that return a grouped treeview of matching codes.
Hierarchical Code Browsing
CPT codes are navigable in three steps. get_cpt_sections returns the major category groups (e.g., Anesthesia, Surgery, Radiology) with their label, range, and url. Pass one of those ranges to get_cpt_section_detail to get child sub-ranges. Only exact leaf-level ranges work with get_cpt_subsection_codes — intermediate ranges return empty results. That endpoint is paginated (0-indexed page parameter, up to 10 codes per page) and uses next_page in the response to signal additional pages. For a single CPT code, get_cpt_code_detail returns description, lay_term, and breadcrumbs alongside the raw code value.
ICD-10-CM and ICD-10-PCS Coverage
ICD-10-CM browsing mirrors the CPT flow: get_icd10cm_sections returns all chapter groupings, and get_icd10cm_section_detail returns child blocks. Note that the detail response includes sibling chapter navigation items alongside true subsections, so filtering by URL is recommended to isolate subsections. get_icd10cm_code_detail returns excludes1, excludes2, and includes arrays, though these clinical notes are populated mainly at category level (e.g., J18, E11) rather than at specific leaf codes (e.g., A01.0). ICD-10-PCS uses a character-by-character hierarchy: get_icd10pcs_sections returns single-character section codes, and repeated calls to get_icd10pcs_detail with progressively longer code_prefix values (e.g., 0, 0B) walk the seven-character structure.
HCPCS Level II and Search
get_hcpcs_sections returns Level II section groupings, but note that the range values are opaque numeric IDs rather than HCPCS alphanumeric code ranges. Pass these IDs to get_hcpcs_section_detail to retrieve codes with code, label, and description fields; some section IDs return empty arrays. search_codes accepts a query string (keyword or code) and an optional year parameter, returning results grouped by code set in a nested treeview array. Labels within the treeview contain inline HTML that may need stripping before display.
Full CPT Hierarchy Traversal
get_cpt_full_hierarchy lets you retrieve a pre-nested CPT structure in a single call by setting max_depth (1 for top-level sections only, 2 to include subsections, 3 to include sub-subsections). Each node in the returned array may contain a children array of the next level down. This is useful for building navigation trees or local code caches without chaining multiple section-detail calls.
- Build a CPT code autocomplete widget using search_codes with procedure keyword queries
- Generate breadcrumb navigation for medical billing UIs using the breadcrumbs field from get_cpt_code_detail
- Validate ICD-10-CM codes in claim submission workflows using get_icd10cm_code_detail's excludes1 and excludes2 arrays
- Populate a code-set selector tree in EHR software using get_cpt_full_hierarchy at max_depth 2
- Cross-reference HCPCS Level II codes with descriptions for DME billing using get_hcpcs_section_detail
- Support medical coding education tools by walking the ICD-10-PCS seven-character hierarchy via get_icd10pcs_detail
- Run year-specific code lookups for compliance auditing using the year parameter in search_codes
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.