> ## Documentation Index > Fetch the complete documentation index at: https://stedi.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Submit professional claims You can send 837P professional claims to payers through the Stedi portal, the Professional Claims API, or an SFTP connection. Once you send a claim, Stedi automatically receives and processes 277CA claim acknowledgment and 835 Electronic Remittance Advice (ERA) responses. ## Before sending claims You may need to complete the following steps before sending claims. ### Transaction enrollment All payers require providers to complete an enrollment process before they can start receiving 835 ERAs. Some payers also require enrollment before allowing providers to submit claims. The [Stedi Payer Network](https://www.stedi.com/healthcare/network) lists which payers require transaction enrollment. Visit [Transaction Enrollment](/healthcare/transaction-enrollment) for details about the transaction enrollment process. ### Coordination of benefits check (recommended) We recommend running a coordination of benefits (COB) check to ensure you submit claims to the correct payer. COB checks can help you determine: * If a patient is covered by more than one health plan * Whether coverage overlap requires coordination of benefits * Each payer’s responsibility for payment (primacy) in coordination of benefits scenarios Visit [Coordination of benefits (COB) checks](/healthcare/coordination-of-benefits) for more information. ## Manual submission Manual claim submission can be useful for testing, QA, and debugging your pipeline. You can submit 837P professional claims manually through the [Create manual claim page](https://portal.stedi.com/app/healthcare/claims/create) in the Stedi portal. The in-app form is based on the [NUCC 1500 claim form](https://nucc.org/index.php/1500-claim-form-mainmenu-35) but doesn’t support every data element. Specifically, it omits some parts of Item 19 (Additional Claim Information) and all of Item 24 supplemental information (shaded area). If you need this data, use the [API endpoints](#api-submission) instead. To help prevent rejections, Stedi validates provider NPIs, diagnosis codes, and other key information. You can also see an auto-generated preview of the corresponding JSON payload for the [Professional Claims API](/api-reference/healthcare/post-healthcare-claims) to understand how the form maps to the request structure. ## SFTP submission You can use Stedi’s fully-managed SFTP server to submit claims to to payers and retrieve claim responses without calling Stedi’s APIs. You must submit claims in X12 EDI format, and Stedi returns claim responses through the SFTP connection in X12 EDI format. This makes Stedi SFTP a good option if you have an existing system that generates X12 EDI files and you want to send them through the Stedi clearinghouse without completing an API integration. Visit [SFTP connection](/healthcare/submit-claims-sftp-connection) for more information. ## API submission Call one of the following endpoints to submit 837P professional claims: * [Professional Claims](/api-reference/healthcare/post-healthcare-claims) to send requests in JSON * [Professional Claims Raw X12](/api-reference/healthcare/post-healthcare-claims-raw-x12) to send requests in X12 EDI Both endpoints return a synchronous response from Stedi in JSON format. Later, the payer will respond with a 277CA claim acknowledgment. ### Headers When constructing the request, you must include the following information in HTTP headers: * **`Authorization`:** [Generate an API key](https://portal.stedi.com/app/settings/api-keys) to use for authentication. * **`Content-Type`:** Set to `application/json`. ### Body - JSON The information you submit for a claim depends on your use case. Refer to the [Professional Claims](/api-reference/healthcare/post-healthcare-claims) endpoint for a complete list of properties. However, all claims require the following high-level information: | Information | Description | | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tradingPartnerServiceId` | This is the payer ID. Visit the [Payer Network](https://www.stedi.com/healthcare/network) for a complete list. | | `tradingPartnerName` | This is the payer's business name, like Cigna or Aetna. | | `submitter` object | Information about the entity submitting the claim. This can be either an individual or an organization, such as a doctor, hospital, or insurance company. | | `receiver` object | Information about the payer, such as an insurance company or government agency. | | `subscriber` and/or `dependent` objects | Information about the patient who received the medical services. Note that if a dependent has their own, unique member ID for their health plan, you should submit their information in the `subscriber` object and omit the `dependent` object from the request. You can check whether the dependent has a unique member ID by submitting an [Eligibility Check](/api-reference/healthcare/post-healthcare-eligibility) to the payer for the dependent. The payer will return the member ID in the `dependents.memberId` field, if present. | | `claimInformation` object | Information about the claim, such as the patient control number, claim charge amount, and place of service code. It also includes information about each individual service line included in the claim. | | `billing` object | Information about the billing provider, such as the [NPI](/healthcare/national-provider-identifier), taxonomy code, and organization name. | #### Service line identification A claim can contain multiple service lines. Since the payer may accept, reject, or pay a subset of those lines, you can receive an 835 ERA that references a `patientControlNumber`, but only pertains to some of the service lines. However, the `claimInformation.serviceLines.providerControlNumber` serves as a unique identifier for each service line in your claim submission. This value appears in the 277CA claim acknowledgment and 835 ERA as the `lineItemControlNumber`, allowing you to correlate these responses to specific service lines from the original claim. If you don't set the `providerControlNumber` for a service line, Stedi uses a random UUID. Stedi returns service line identifiers in the `claimReference.serviceLines` object of the synchronous API response. #### Conditional requirements Note that objects marked as **required** are required for all requests, while others are conditionally required depending on the circumstances. When you include a conditionally required object, you must include all of its required properties. For example, you must always include the `subscriber` object in your request, but you only need to include the `supervising` object when the rendering provider is supervised by a physician. ### Body - X12 EDI In addition to sending a payload in [837 X12 EDI format](https://portal.stedi.com/app/guides/view/hipaa/health-care-claim-professional-x222a1/01HR60MDFAGCSEJNKY8J38867Y), note the following requirements and behavior when sending professional claims through the raw X12 endpoint. #### Payer ID You must submit a payer identifier in `Loop 2010BB` (Payer Name) `NM109` so Stedi can route your claim to the correct payer. This identifier **must** be a payer ID or payer ID alias listed in the [Payer Network](https://www.stedi.com/healthcare/network?page=0). For example, you could use `60054`, `HPQRS`, `AETNA`, or any other listed payer ID alias for Aetna. #### `CLM01` (Patient Control Number) We **strongly recommend** submitting a unique value for `Loop 2300` (Claim Information) `CLM01` (Patient Control Number). The payer returns this value in related transactions, such as the 277CA and 835 ERA, so you can correlate responses and real-time claim status checks with the original claim. We recommend using only alphanumeric characters and generating unique values that are the shortest possible length. Stedi accepts any valid value, but some payers replace non-alphanumeric characters and truncate shorter than the official 20-character limit. When this happens, the payer returns a different identifier in responses than the one you originally sent, making it more difficult to correlate the claim and perform real-time claim status checks. #### Service line identification A claim can contain multiple service lines. Since the payer may accept, reject, or pay a subset of those lines, you can receive an 835 response that references a patient control number, but only pertains to some of the service lines. However, the line item control number serves as a unique identifier for each service line in your claim submission. * You can set the line item control number in `Loop 2400 REF02`, when `REF01` = `6R`. The line item control number appears in the 277CA and 835 ERA responses as the `lineItemControlNumber`, allowing you to correlate these responses to specific service lines from the original claim. * If you don’t set the line item control number for a service line, Stedi uses a random UUID. * Stedi returns service line identifiers in the `claimReference.serviceLines` object of the synchronous API response. ### Character restrictions Only use the X12 Basic and Extended character sets in request data. Using characters outside these sets may cause validation and HTTP `400` errors. The X12 Basic character set includes uppercase letters, digits, space, and some special characters. Lowercase letters and special language characters like `ñ` are not included. The following special characters are included: ![Basic special characters](https://mintlify.s3.us-west-1.amazonaws.com/stediinc/images/basic-special-characters.png) The Extended character set includes the characters listed in Basic, plus lowercase letters and additional special characters, such as `@`. The following additional special characters are included: ![Extended special characters](https://mintlify.s3.us-west-1.amazonaws.com/stediinc/images/extended-special-characters-healthcare.png) In addition, the following characters are reserved for delimiters in the final X12 EDI transaction to the payer: `~`, `*`, `:`, and `^`. X12 doesn’t support using escape sequences to represent delimiters or special characters. Stedi returns a `400` error if you use these restricted characters improperly. * **JSON endpoint:** Don’t include delimiter characters anywhere in your request data. * **Raw X12 endpoint:** You can use these characters as delimiters, but not in the body of the request data. ### Sample request and response The following examples send a professional claim. The response shape is the same for both the JSON and X12 EDI endpoints. It contains summary information from Stedi about the claim submission and whether it was successful. {/* schema:ClaimsSubmissionRequestContent */} {/* replace::1234567890*/} {/* replace::1234567890*/} ```bash Request - JSON curl --request POST \ --url https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/professionalclaims/v3/submission \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data '{ "usageIndicator": "T", "tradingPartnerServiceId": "6400", "submitter": { "organizationName": "Test Data Health Services, Inc.", "submitterIdentification": "", "contactInformation": { "name": "Test Data Health Services, Inc.", "phoneNumber": "5552223333" } }, "receiver": { "organizationName": "Cigna" }, "subscriber": { "memberId": "U7777788888", "paymentResponsibilityLevelCode": "P", "subscriberGroupName": "Cigna", "firstName": "John", "lastName": "Anon", "gender": "M", "dateOfBirth": "20000101", "groupNumber": "3335555", "address": { "address1": "2222 Random St", "city": "A City", "state": "NY", "postalCode": "123450000" } }, "billing": { "providerType": "BillingProvider", "npi": "", "employerId": "123456789", "taxonomyCode": "2084P0800X", "organizationName": "Therapy Associates", "address": { "address1": "123 Some St", "address2": "Floor 1", "city": "A City", "state": "NY", "postalCode": "123450000" }, "contactInformation": { "name": "Test Data Health Services, Inc.", "phoneNumber": "5553334444" } }, "claimInformation": { "claimFilingCode": "CI", "patientControlNumber": "", "claimChargeAmount": "109.20", "placeOfServiceCode": "02", "claimFrequencyCode": "1", "signatureIndicator": "Y", "planParticipationCode": "A", "benefitsAssignmentCertificationIndicator": "Y", "releaseInformationCode": "Y", "healthCareCodeInformation": [ { "diagnosisTypeCode": "ABK", "diagnosisCode": "F1111" } ], "serviceFacilityLocation": { "organizationName": "Smith Associates", "address": { "address1": "1234 Other St", "city": "A City", "state": "NY", "postalCode": "123450000" }, "npi": "1999999984" }, "serviceLines": [ { "serviceDate": "20240101", "professionalService": { "procedureIdentifier": "HC", "procedureCode": "90837", "procedureModifiers": [ "95" ], "lineItemChargeAmount": "109.20", "measurementUnit": "UN", "serviceUnitCount": "1", "compositeDiagnosisCodePointers": { "diagnosisCodePointers": [ "1" ] } }, "providerControlNumber": "111222333", "renderingProvider": { "providerType": "RenderingProvider", "npi": "", "taxonomyCode": "111YP2000X", "firstName": "Jane", "lastName": "Smith" } } ] }, "tradingPartnerName": "Cigna" }' ``` ```bash Request - X12 EDI curl --request POST \ --url https://healthcare.us.stedi.com/2024-04-01/change/medicalnetwork/professionalclaims/v3/raw-x12-submission \ --header 'Authorization: ' \ --header 'Content-Type: application/json' \ --data '{ "x12": "ISA*00* *00* *ZZ*001690149382 *ZZ*STEDITEST *240630*0847*^*00501*000000001*0*T*>~GS*HC*001690149382*STEDITEST*20240630*084744*000000001*X*005010X222A1~ST*837*0001*005010X222A1~BHT*0019*00*01J1M588QT2TAV2N093GNJ998T*20240630*0847*CH~NM1*41*2*Test Data Health Services, Inc.*****46*123567890~PER*IC*Test Data Health Services, Inc.*TE*5552223333~NM1*40*2*Cigna*****46*60054~HL*1**20*1~PRV*BI*PXC*2084P0800X~NM1*85*2*Therapy Associates*****XX*1999999984~N3*123 Some St*Floor 1~N4*A City*NY*123450000~REF*EI*832675429~PER*IC*Test Data Health Services, Inc.*TE*5553334444~HL*2*1*22*0~SBR*P*18*3335555******CI~NM1*IL*1*Anon*John****MI*U7777788888~N3*2222 Random St~N4*A City*NY*123450000~DMG*D8*20000101*M~NM1*PR*2*Cigna*****PI*60054~CLM*22266555*109.0***02>B>1*Y*A*Y*Y~HI*ABK>F1111~NM1*82*1*Smith*Jane****XX*1999999984~PRV*PE*PXC*111YP2000X~NM1*77*2*Smith Associates*****XX*1999999984~N3*1234 Other St~N4*A City*NY*123450000~LX*1~SV1*HC>90837>95*109.2*UN*1.0***1~DTP*472*D8*20240101~SE*30*0001~GE*1*000000001~IEA*1*000000001~" }' ``` {/* schema:ClaimsSubmissionResponseContent */} ```json Response { "status": "SUCCESS", "controlNumber": "555123", "tradingPartnerServiceId": "6400", "claimReference": { "correlationId": "01HTQX03MMP4XHBT4QBGDAD9DG", "patientControlNumber": "22266555", "timeOfResponse": "2024-04-05T19:50:34.275Z", "payerID": "6400", "formatVersion": "5010", "rhclaimNumber": "01HTQX03MMP4XHBT4QBGDAD9DG" }, "httpStatusCode": "200 OK", "meta": { "traceId": "bef31123-34d8-46b6-b1ff-2a534d0e9a06" }, "payer": { "payerName": "Cigna", "payerID": "6400" } } ``` ### Test claims All claims you submit through the API are sent to the payer as production claims unless you explicitly designate them as test data. To send test claims: * **JSON endpoint:** Set the `usageIndicator` property in the test claim body to `T`. * **X12 EDI endpoint:** Set `ISA15` (Interchange Usage Indicator) to `T` (Test Data) instead of `P` (Production Data). When you send a test claim, Stedi does not send it to the payer. Instead, it processes the claim as if it were sent to the payer and returns a response indicating whether the claim was successfully processed. Designating a claim as test data allows you to filter for test claims on the [Transactions](https://portal.stedi.com/app/core/transactions) page in the Stedi portal. Note that you will receive a 277CA claim acknowledgment in response to test claims, allowing you to test your workflow end to end, but you will not receive a test 835 ERA response. ### Recommended API clients You may want to use an API client to make testing and debugging easier. We **don't recommend** using Postman for requests containing Protected Health Information (PHI) because Postman defaults to storing request history - including full request payloads - on its cloud servers. You can’t turn this feature off without impractical workarounds. Visit [API clients](/api-reference#api-clients) for a list of recommended clients you can use instead. ## Claim Filing Indicator Code The Claim Filing Indicator Code indicates how a claim was filed with a payer, such as `MC` (Medicaid) or `CI` (Commercial Insurance Co.). Choosing the correct claim filing indicator code is important for successful claim submission. Visit the [Claims code lists](/healthcare/claims-code-lists#choosing-the-right-code) documentation for best practices for selecting the appropriate code. ## 275 claim attachments If the claim requires attachments, you must include additional details about the attachments in the appropriate objects: * Attachments for entire claim: [`claimInformation.claimSupplementalInformation.reportInformation`](/api-reference/healthcare/post-healthcare-claims#body-claim-information-claim-supplemental-information-report-information) * Attachments for a specific service line: [`claimInformation.serviceLines.serviceLineSupplementalInformation`](/api-reference/healthcare/post-healthcare-claims#body-claim-information-service-lines-service-line-supplemental-information) Visit [Claim attachments](/healthcare/submit-claim-attachments) for complete instructions. ## Cancel or resubmit claims You may need to resubmit claims for several reasons, including changes to the patient's coverage, errors in the original claim's information, or appealing a denied claim. You may also need to cancel duplicate claims or claims that were submitted in error. We recommend the following for resubmitting or canceling claims: * **Correct or replace claims:** Set `claimInformation.claimFrequencyCode` to `7` - Replacement of Prior Claim. We also recommend setting a new, unique `patientControlNumber`. The payer includes this value in their 835 ERA, allowing you to easily correlate that response with your resubmission. * **Cancel claims :** Set `claimInformation.claimFrequencyCode` to `8` - Void/Cancel of Prior Claim. In both cases, identify the original claim by setting `claimInformation.claimSupplementalInformation.claimControlNumber` to the Payer Claim Control Number (sometimes called the ICN). This is different from the `patientControlNumber` you sent in the claim and the Stedi-generated `controlNumber` returned in the API response. You can retrieve the Payer Claim Control Number from one of the payer's 277CA claim acknowledgments in the `transactions.payers.claimStatusTransactions.claimStatusDetails.patientClaimStatusDetails.claims.claimStatus.tradingPartnerClaimNumber` property. ## Submit to a secondary or tertiary payer In [coordination of benefits (COB)](/healthcare/coordination-of-benefits) scenarios, you'll need to submit a claim to multiple payers. You must set the `subscriber.paymentResponsibilityLevelCode` to either `S` (when submitting to the secondary payer) or `T` (when submitting to the tertiary payer). You must also include the following information about how prior payers have adjudicated the claim. For example, if a patient's private insurance plan (primary payer) adjusted the requested reimbursement amount and paid for its portion of the services, you must include that information in the claim you submit to Medicare (secondary payer). You can find these details in 835 ERA responses from prior payers. ### Claim information You must submit one `claimInformation.otherSubscriberInformation` object for each prior payer. Supply all the required properties in the object plus the following additional information: * `claimLevelAdjustments`: Provide if the prior payer made adjustments at the claim level. Codes and their associated amounts must come from ERAs sent by the prior payers. You can find these codes in the ERA's [`transactions.detailInfo.paymentInfo.claimAdjustments`](/api-reference/healthcare/get-healthcare-reports-835#response-transactions-detail-info-payment-info-claim-adjustments) object. * `medicareInpatientAdjudication` (institutional claims only): You must include this if Medicare was one of the prior payers and reported inpatient adjudication information on the ERA. * `medicareOutpatientAdjudication`: You must include this if Medicare was one of the prior payers and reported outpatient adjudication information on the ERA. * `otherPayerName.otherPayerAdjudicationOrPaymentDate`: The date the payer adjudicated or paid the claim. You must provide this if you aren't providing a value in the `claimInformation.serviceLines.lineAdjudicationInformation.adjudicationOrPaymentDate` property. * `payerPaidAmount`: This is the total amount in dollars the payer paid on this claim. ### Service line information You must submit `serviceLines.lineAdjudicationInformation` objects when the prior payers provided line-level adjudication information. Submit one object for each prior payer. For each object, you should include the following properties. * `adjudicationOrPaymentDate`: The date the payer adjudicated or paid the claim. Don't include this if you're providing a date in the `otherPayerName.otherPayerAdjudicationOrPaymentDate` property. * `claimAdjustmentInformation`: You can find this information in the ERA's [`transactions.detailInfo.paymentInfo.serviceLines.serviceAdjustments`](/api-reference/healthcare/get-healthcare-reports-835#response-transactions-detail-info-payment-info-service-lines-service-adjustments) object. * `otherPayerPrimaryIdentifier`: The identifier for the other payer. This value should match the identifier you supplied for the payer in the `claimInformation.otherSubscriberInformation.otherPayerName.otherPayerIdentifier` property. * `procedureCode`: The adjudicated procedure code for the service line. * `serviceIdQualifier`: A code identify the type of procedure code. Visit [Claims code lists](/healthcare/claims-code-lists#composite-medical-procedure-product-or-service-id-qualifier-codes) for a complete list. * `serviceLinePaidAmount`: The total amount in dollars the prior payer paid on this service line. * `paidServiceUnitCount`: The number of paid units for the service line. When paid units are not present on the remittance advice, use the original billed units. * `remainingPatientLiability`: The amount of the service line the patient is responsible for paying. ## View submitted claims You can view the files that Stedi sends and receives on the [Files](https://portal.stedi.com/app/core/file-executions) page of the Stedi portal. On the [Transactions](https://portal.stedi.com/app/core/transactions) page, you can review and filter claims by **Usage** - production or test. Click any claim submission to review its details, including the full request and response payload, processing events, and a link to download the auto-generated 1500 Claim Form PDF. ## Set a claim's correlation ID A claim's correlation ID is a business identifier that you can use to track and manage claims. * When you submit claims through the JSON endpoint, Stedi generates the correlation ID for you, and this value will be unique for each claim. * When you submit claims in X12 EDI through the API or an [SFTP connection](/healthcare/submit-claims-sftp-connection), you can specify your own correlation ID in the `BHT03` element. This allows you to use the same value for multiple claims if desired. ## CMS-1500 claim form PDF Stedi automatically generates a PDF [CMS-1500 claim form](https://www.nucc.org/index.php/1500-claim-form-mainmenu-35) for each professional claim you submit. You can manually download the form on the transaction details page for the claim in the Stedi portal or retrieve them programmatically through the following endpoints: * [CMS-1500 PDF: Business Identifier](/api-reference/healthcare/get-pdf-1500-business-identifier): Retrieve PDFs through a claim's business identifier. You can find the business identifier value in the `claimReference.correlationId` property Stedi returns in the synchronous claim submission response. * [CMS-1500 PDF: Transaction ID ](/api-reference/healthcare/get-pdf-1500): Retrieve PDFs through the `transactionId` Stedi assigns to the processed claim. This ID is included in the transaction processed event for the claim, which you can receive automatically through [webhooks](/healthcare/configure-webhooks). You can also retrieve this ID from the transaction's details page in Stedi. Payers have strict requirements for submitted CMS-1500 claim forms. If you plan to send generated PDFs to payers or retain them for your records, we strongly recommend visiting [CMS-1500 Claim Form PDF](/healthcare/cms-1500-claim-form-pdf) for information about how to structure claim submissions for optimal generation, the correct printer settings for generated PDFs, and general best practices.