Introducing the CMS-1500 Professional Claim API endpoints
You can now submit, validate, and retrieve 837P professional claims through JSON API endpoints that mirror the CMS-1500 paper form.
| Endpoint | What it does |
|---|---|
| CMS-1500 Create Professional Claim Submission | Accepts a claim submission in a CMS-1500 JSON structure, validates the claim using Stedi's database of claim edits, and sends the claim to the payer. |
| CMS-1500 Validate Professional Claim Submission | Validates the claim using Stedi's database of claim edits without sending the claim to the payer. Returns an empty 200 response if the claim passes Stedi's edits, or an error if it doesn't. |
| CMS-1500 Retrieve Professional Claim Submission | Returns a submitted claim in the CMS-1500 JSON structure. You can then make corrections to the claim and resubmit it using the CMS-1500 Create Professional Claim Submission endpoint. |
The CMS-1500 – also called the HCFA form – is the standard paper form for professional claims. Every box on the form has a number. Many billers know these numbers. Payers cite them in their own guides. And many AI agents are trained on them.
Until now, only the Stedi portal's professional claim form mirrored the CMS-1500. Our JSON 837P Professional Claim Submission endpoint uses a separate schema.
Now developers and AI agents can apply what they know about the CMS-1500 to Stedi's API. The new endpoints are the same ones that power Stedi's own claim form.
Important: We're not deprecating the JSON 837P Professional Claim Submission endpoint or any other functionality as part of this release. Your existing integrations will continue working.
Watch the 2026 Stedi Keynote announcement:
Request shapes
The new endpoints group fields the same way the CMS-1500 form does. The API reference includes the box number for most fields.
For example, Box 24 – Service lines of the CMS-1500 form is the grid where you list each service you bill. One row of that grid is one object in the serviceLines array.
Test mode support
You can use the CMS-1500 Create Professional Claim Submission and CMS-1500 Retrieve Professional Claim Submission endpoints in test mode. You need a test API key for a Stedi production account.
The CMS-1500 Validate Professional Claim Submission endpoint is not supported in test mode.
Sandbox accounts can't use the CMS-1500 endpoints. To submit test claims, upgrade to a production account.
Limitations
The CMS-1500 endpoints don't support claims for non-primary payers, such as a secondary payer, when the patient is covered by more than one insurance plan. To submit a professional claim to a non-primary payer, use the JSON 837P Professional Claim Submission endpoint, Raw X12 837P Professional Claim Submission endpoint, or SFTP instead.
Availability and pricing
The CMS-1500 endpoints are available on all Stedi production accounts.
Claim retrieval is free. Test claim submissions are free. Production claim submissions and validations are priced per transaction. For pricing, see our Pricing page.
For more details, see our announcement blog.