Docs · Validators
cpt_code validator
AMA CPT — exactly 5 digits, no checksum.
Reference
Format
Matches `/^\d{5}$/`. Exactly 5 digits.
Examples
- 99213 (Office visit, established patient, 20-29 min)
- 93000 (Electrocardiogram, routine)
- 36415 (Routine venipuncture)
How it runs
Implementation
Faithful summary of lib/validators.ts. Validators are pure functions and run identically in the worker, the Workbench, and the MCP server.
function validCpt(value) {
return /^\d{5}$/.test(value)
? OK
: fail('cpt_format', 'expected 5 digits')
}Config
Use in a template
Validators attach to a field on a custom template. The cascade runs them after mapping but before commit; failures surface in the per-row validation report.
fields:
- column: cpt_code
type: string
validators:
- type: cpt_codeWatch out
Common gotchas
- HCPCS Level II codes (one letter + 4 digits, e.g. `J3490`) are rejected. Use a separate validator if you mix CPT and HCPCS.
- CPT Category II (4 digits + `F`) and Category III (4 digits + `T`) codes also fail the shape — they are not pure 5-digit.
- No AMA registry lookup. `00000` and `99999` both pass the format check.
Catalogue
Related templates
- Claims line items
claims_line_items_v1CPT/ICD-10-coded claim line items.
Fields:
cpt_code
Pricing
Validators run on every committed row
Validators add no AI cost — they are pure functions. Every map bills a small flat per-map fee from your prepaid token wallet ($10 minimum, shared across our suite); only columns that reach the metered LLM layer, plus any-to-any convert and reshape, bill real AI tokens. See pricing →
Explore
Other validators
Back to the documentation index or browse the template catalogue.
Ready when you are
Validate every row — before it lands.
Attach checksum-strict validators to any field, and gate risky commits with the requires_hitl flag. One key runs the whole cascade.