# 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 boxes on the CMS-1500 paper form.

Published Sep 9, 2026

Product: Claims

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                                                                                                                                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create Professional Claim (CMS-1500) JSON](https://www.stedi.com/docs/healthcare/api-reference/post-create-professional-claim-json)     | Accepts a claim submission in a CMS-1500 JSON structure, validates the claim using Stedi's [database of claim edits](https://www.stedi.com/docs/healthcare/claim-edits-and-repairs), and sends the claim to the payer.                                                        |
| [Validate Professional Claim (CMS-1500) JSON](https://www.stedi.com/docs/healthcare/api-reference/post-validate-professional-claim-json) | 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.                                                                                 |
| [Retrieve Professional Claim (CMS-1500) JSON](https://www.stedi.com/docs/healthcare/api-reference/get-professional-claim-json)           | Returns a submitted claim in the CMS-1500 JSON structure. You can then make corrections to the claim and resubmit it using the [Create Professional Claim (CMS-1500) JSON](https://www.stedi.com/docs/healthcare/api-reference/post-create-professional-claim-json) endpoint. |

The [CMS-1500](https://www.nucc.org/index.php/1500-claim-form-mainmenu-35) – 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](https://www.stedi.com/docs/healthcare/submit-professional-claims-ui#cms-1500-claim-form) mirrored the CMS-1500. Our [JSON 837P Professional Claim Submission](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-claims) 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](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-claims) endpoint or any other functionality as part of this release. Your existing integrations will continue working.

**Watch the 2026 Stedi Keynote announcement:**

[Introducing the CMS-1500 Professional Claim API endpoints - 2026 Stedi Keynote](https://www.youtube.com/watch?v=8s18ytDvUGc)

## 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.

Box 24 service lines grid on the CMS-1500 form

## Test mode support

You can use the Create Professional Claim (CMS-1500) JSON and Retrieve Professional Claim (CMS-1500) JSON endpoints in [test mode](https://www.stedi.com/docs/healthcare/test-mode). You need a [test API key](https://www.stedi.com/docs/healthcare/test-mode#generate-test-api-keys) for a Stedi production account.

The [Validate Professional Claim (CMS-1500) JSON](https://www.stedi.com/docs/healthcare/api-reference/post-validate-professional-claim-json) 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](https://www.stedi.com/pricing).

## 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](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-claims) endpoint, [Raw X12 837P Professional Claim Submission](https://www.stedi.com/docs/healthcare/api-reference/post-healthcare-claims-raw-x12) endpoint, or [SFTP](https://www.stedi.com/docs/healthcare/intro-to-claim-submission#sftp-claim-submission) 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](https://www.stedi.com/pricing).

For more details, see our [announcement blog](https://www.stedi.com/blog/introducing-the-cms-1500-professional-claim-api-endpoints).