STstedi

POST /professional-claim-submissions

Changed on

Submit a professional claim in JSON modeled after the CMS-1500 form structure

Request

  • Base URL
    https://claims.us.stedi.com/2025-03-07
  • URL
    https://claims.us.stedi.com/2025-03-07/professional-claim-submissions
  • Auth
    API key in header Authorization

Headers

Idempotency-Keystring

A unique string to identify this request to the server. You can safely retry requests with the same idempotency key within 24 hours of making the first request. This prevents you from sending duplicate claims due to network errors or other intermittent failures. If you reuse a key on a new request while Stedi is still processing the original, Stedi returns a 409 Conflict error. Learn more.

Request body

purpose'SUBROGATION_DEMAND' | 'CHARGEABLE' | 'REPORTING' required

The purpose of the claim submission.

  • CHARGEABLE: A standard fee-for-service claim with at least one chargeable line item. Use this for most submissions.
  • SUBROGATION_DEMAND: Only for use by state Medicaid agencies performing post-payment recovery.
  • REPORTING: A reporting-only submission that is not a request for payment.

Response

CreateProfessionalClaimSubmission 201 response

claimIdstring required

A unique identifier for the claim within Stedi. This ID stays the same throughout the claim's entire lifecycle. For example, the claim ID is the same for the initial submission and any resubmissions. This is how Stedi links a particular claim to responses, such as 277CA claim acknowledgments.

submissionIdstring required

A unique identifier for a specific submission of a claim within Stedi. Stedi generates a submission ID for the initial submission and then a new submission ID for every resubmission of the same claim. This is different from the claim ID, which doesn't change throughout the claim's lifecycle.

Changes

  • b4f2a7ab03b0Revision changes
    • breaking

      the / request property's minLength was increased from 0 to 1

    • breaking

      the / request property's minLength was increased from 0 to 1

    • breaking

      the /// request property's minLength was increased from 0 to 1

    • breaking

      the // request property's minLength was increased from 0 to 1

    • breaking

      the /// request property's minLength was increased from 0 to 1

    • breaking

      the // request property's minLength was increased from 0 to 1

    • warning

      the / request property's maxLength was set to 17

    • warning

      the / request property's maxLength was set to 17

    • warning

      the /// request property's maxLength was set to 17

    • warning

      the // request property's maxLength was set to 17

    • warning

      the /// request property's maxLength was set to 17

    • warning

      the // request property's maxLength was set to 17

    • warning

      changed the pattern of the request property / from ^\d+(\.\d{1,2})?$ to ^-?\d*\.?\d+$

    • warning

      changed the pattern of the request property / from ^\d+(\.\d{1,2})?$ to ^-?\d*\.?\d+$

    • warning

      changed the pattern of the request property /// from ^\d{1,8}(\.\d{1,3})?$ to ^-?\d*\.?\d+$

    • warning

      changed the pattern of the request property // from ^\d+(\.\d{1,2})?$ to ^-?\d*\.?\d+$

    • warning

      changed the pattern of the request property /// from ^\d+(\.\d{1,2})?$ to ^-?\d*\.?\d+$

    • warning

      changed the pattern of the request property // from ^\d{1,8}(\.\d{1,3})?$ to ^-?\d*\.?\d+$

  • 9191e8cf4519Revision changes
    • info

      endpoint added