277CA Report

This endpoint retrieves processed 277 Claim Acknowledgment (277CA) transactions from payers.

• Call this endpoint with the transactionId of the 277CA you want to retrieve.
• Stedi returns the payer’s 277CA in JSON format.

Correlate with original claim

Use the following fields to correlate the 277CA with the original claim:

Entire Claim

The original claim’s claimInformation.patientControlNumber is returned in two locations in the 277CA:

• transactions.payers.claimStatusTransactions.claimStatusDetails.patientClaimStatusDetails.claims.claimStatus.patientAccountNumber
• transactions.payers.claimStatusTransactions.claimStatusDetails.patientClaimStatusDetails.claims.claimStatus.referencedTransactionTraceNumber

You can use either of these properties to correlate the 277CA with the original claim, but we recommend using the referencedTransactionTraceNumber.

Service line

The original claim’s claimInformation.serviceLines.providerControlNumber is sometimes returned as the transactions.payers.claimStatusTransactions.claimStatusDetails.patientClaimStatusDetails.claims.serviceLines.lineItemControlNumber in the 277CA.

This is because a 277CA only contains a serviceLines object (which contains the lineItemControlNumber) if it was rejected because of issues with the information provided for the service line.

You can review a complete response with a rejected claim in ConvertReport277_example2. The following snippet also shows a serviceLines object for a rejected claim containing the lineItemControlNumber property.

Example serviceLines object from 277CA for rejected claim

"serviceLines": [
  {
    "beginServiceLineDate": "20250101",
    "lineItemControlNumber": "ABCD1234",
    "service": {
      "chargeAmount": "379.39",
      "procedureCode": "97153",
      "serviceIdQualifierCode": "HC",
      "serviceIdQualifierCodeValue": "Health Care Financing Administration Common Procedural Coding System (HCPCS) Codes",
      "submittedUnits": "11"
    },
    "serviceClaimStatuses": [
      {
        "serviceStatuses": [
          {
            "entityIdentifierCode": "IL",
            "entityIdentifierCodeValue": "Insured or Subscriber",
            "healthCareClaimStatusCategoryCode": "A3",
            "healthCareClaimStatusCategoryCodeValue": "Acknowledgement/Returned as unprocessable claim-The claim/encounter has been rejected and has not been entered into the adjudication system.\n",
            "statusCode": "164",
            "statusCodeValue": "Entity's contract/member number."
          }
        ]
      }
    ]
  }
]

Authorizations

Authorization

string

header

required

A Stedi API Key for authentication.

Path Parameters

transactionId

string

required

A unique identifier for the processed 277 transaction within Stedi. This ID is included in the transaction processed event, which you can receive automatically through Stedi webhooks. You can also retrieve it through the Poll Transactions endpoint or from the transaction's details page within the Stedi portal.

Response

200

application/json

ConvertReport277 200 response

meta

object

required

Metadata that helps Stedi track and debug the response.

Show child attributes

meta.transactionId

string

The Stedi transaction identifier.

meta.applicationMode

string

Whether this is a test or production ERA.

meta.senderId

string

Stedi's identifier for the ERA sender.

meta.traceId

string

Not currently used.

transactions

object[]

The payer's 277 response.

Show child attributes

transactions.controlNumber

string

The control number the the payer provided in the claim status response. This is used to identify the transaction.

transactions.referenceIdentification

string

A number the payer assigns to the transaction to identify it within their system.

transactions.transactionSetCreationDate

string

The date the payer created the transaction, expressed as YYYYMMDD.

transactions.transactionSetCreationTime

string

The time the payer created the transaction, expressed in 24-hour clock time. May be formatted as HHMM, HHMMSS, HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99).

transactions.payers

object[]

Information about the payer (or intermediary clearinghouse) and the claim status transactions included in the response.

Show child attributes

transactions.payers.organizationName

string

The payer or intermediary clearinghouse's business name.

transactions.payers.entityIdentifierCode

enum<string>

Code identifying the type of organization.

Available options:

AY,

PR

transactions.payers.entityIdentifierCodeValue

enum<string>

The human-readable description of the entity identifier code.

Available options:

Clearinghouse,

Payer

transactions.payers.etin

string

The payer's Electronic Transmitter Identification Number.

transactions.payers.federalTaxpayerIdentificationNumber

string

The payer's Federal Taxpayer Identification Number.

transactions.payers.payerIdentification

string

The payer's unique identifier.

transactions.payers.centersForMedicareAndMedicaidServicePlanId

string

The payer's Centers for Medicare and Medicaid Services Plan ID. This is specifically for Health Plan ID (HPID) or Other Entity Identifier (OEID), both of which are no longer mandated for use.

transactions.payers.payerContactInformation

object

The payer's business contact information.

Show child attributes

transactions.payers.payerContactInformation.contactName

string

The name of the contact person or entity.

transactions.payers.payerContactInformation.contactMethods

object[]

Each contact will have a single property set, except for phone with extension.

Show child attributes

transactions.payers.payerContactInformation.contactMethods.electronicDataInterChangeAccessNumber

string

The Electronic Data Interchange Access Number.

transactions.payers.payerContactInformation.contactMethods.email

string

The email address.

transactions.payers.payerContactInformation.contactMethods.fax

string

The fax number.

transactions.payers.payerContactInformation.contactMethods.phone

string

The telephone number including the area code (if applicable). Phone numbers are formatted as AAABBBCCCC, where AAA represents the area code, BBB represents the telephone number prefix, and CCCC represents the telephone number. Phone numbers are provided without separators, such as dashes or parentheses. For example, 5551123345 for 555-112-3345.

transactions.payers.payerContactInformation.contactMethods.phoneExtension

string

The telephone extension, if applicable.

transactions.payers.claimStatusTransactions

object[]

Claim status details.

Show child attributes

transactions.payers.claimStatusTransactions.provider

object

Information about the provider receiving the claim status details.

Show child attributes

transactions.payers.claimStatusTransactions.provider.organizationName

string

The provider's business name. Can be up to 60 characters.

transactions.payers.claimStatusTransactions.provider.lastName

string

The provider's last name. Can be up to 60 characters.

transactions.payers.claimStatusTransactions.provider.firstName

string

The provider's first name. Can be up to 35 characters.

transactions.payers.claimStatusTransactions.provider.middleName

string

The provider's middle name or initial. Can be up to 25 characters.

transactions.payers.claimStatusTransactions.provider.etin

string

The provider's Electronic Transmitter Identification Number.

transactions.payers.claimStatusTransactions.claimTransactionBatchNumber

string

The payer's unique identifier for the claim.

transactions.payers.claimStatusTransactions.providerClaimStatuses

object[]

Overall status information for the claim.

Show child attributes

transactions.payers.claimStatusTransactions.providerClaimStatuses.statusInformationEffectiveDate

string

The date the claim status information is effective.

transactions.payers.claimStatusTransactions.providerClaimStatuses.providerStatuses

object[]

The status of the entire claim.

Show child attributes

transactions.payers.claimStatusTransactions.claimStatusDetails

object[]

More detailed status information. This includes information about the patient, provider, and services rendered.

Show child attributes

transactions.payers.claimStatusTransactions.claimStatusDetails.serviceProvider

object

Information about the service provider.

Show child attributes

transactions.payers.claimStatusTransactions.claimStatusDetails.providerOFServiceInformationTraceIdentifier

string

An identifier for claims related to this provider.

transactions.payers.claimStatusTransactions.claimStatusDetails.serviceProviderClaimStatuses

object[]

Status information for claims related to the provider.

Show child attributes

transactions.payers.claimStatusTransactions.claimStatusDetails.patientClaimStatusDetails

object[]

Patient information and the status of claims related to the patient.

Show child attributes