Redox | Claim

Claim

Claims are sent from a healthcare provider to an insurer detailing the services provided. Claim transactions between a payor and provider can include: a submission of a payment request, the status of that submission, the details of the payment, and the explanation of benefits (EOB).

Claims FAQ^

SubmissionBatch
PaymentBatch
Submission
Payment

SubmissionBatch

DEV PREVIEW

SubmissionBatch message is used to send a payment request, typically from a healthcare provider to an insurer. This is functionally identical to the Submission Event, but allows for multiple transactions to be sent in a batch.

Fields

Show Required Fields Only

Show Translation Fields

Meta
- Meta.DataModel
  String
  Reliable
  Required
  Claim
- Meta.EventType
  String
  Reliable
  Required
  SubmissionBatch
- Meta.EventDateTime
  DateTime
  Reliable
  DateTime of the event.
  ISO 8601 Format
- Meta.Test
  Boolean
  Reliable
  Flag as a test message
- Meta.Source
  String
  Reliable
  Where the message originated.
  Included in messages from Redox
- Meta.Source.ID
  String
  Reliable
  ID of the source.
  UUID
- Meta.Source.Name
  String
  Reliable
  Name of the source
- Meta.Destinations[]
  Array of Objects
  Reliable
  List of destinations to send your message to. All messages must have at least one destination. Queries accept only one destination.
  Required when sending data to Redox
- Meta.Destinations[].ID
  String
  Reliable
  ID of the destination.
  UUID
- Meta.Destinations[].Name
  String
  Reliable
  Name of the destination
- Meta.Logs[]
  Array of Objects
  Reliable
  Request log identifiers.
- Meta.Logs[].ID
  String
  Reliable
  ID of a request log that corresponds to this request, used for support and reference within the Redox dashboard.
  UUID
- Meta.Logs[].AttemptID
  String
  Reliable
  ID of request log attempt. Useful in cases where retries are possible.
  UUID
- Meta.Message
  String
  Reliable
  Record in Redox that corresponds to the communication sent from the source to Redox.
  Included in messages from Redox
- Meta.Message.ID
  Numeric
  Reliable
  ID of the message created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.Transmission
  String
  Reliable
  Record in Redox that corresponds to the communication sent from Redox to your destination.
  Included in messages from Redox
- Meta.Transmission.ID
  Numeric
  Reliable
  ID of the transmission created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.FacilityCode
  String
  Possible
  Code for the facility related to the message.
  Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Transactions
- Transactions[].ID
  String
  Reliable
  ID used by submitter to reference this Claim Submission
- Transactions[].IDType
  String
  Reliable
  Type of ID
- Transactions[].Type
  String
  Reliable
  ValueSet
  The type of Claim Submission, Institutional or Professional
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submitter
  Object
  Reliable
  Submitter of a Claim Submission
- Transactions[].Submitter.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Submitter.Identifiers[].ID
  String
  Reliable
  ID for the submitter
- Transactions[].Submitter.Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Submitter.Name
  String
  Reliable
- Transactions[].Submitter.Address
  Object
  Probable
  Address of the Submitter
- Transactions[].Submitter.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Submitter.Address.City
  String
  Probable
  City
- Transactions[].Submitter.Address.State
  String
  Probable
  State
- Transactions[].Submitter.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Submitter.Address.County
  String
  Possible
  County
- Transactions[].Submitter.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submitter.EmailAddress
  String
  Probable
- Transactions[].Submitter.PhoneNumber.Office
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submitter.PhoneNumber.Fax
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Receiver
  Object
  Reliable
  Receiver of a Claim Submission
- Transactions[].Receiver.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Receiver.Identifiers[].ID
  String
  Reliable
  ID for the receiver
- Transactions[].Receiver.Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Receiver.Name
  String
  Reliable
- Transactions[].Receiver.Address
  Object
  Probable
  Address of the Receiver
- Transactions[].Receiver.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Receiver.Address.City
  String
  Probable
  City
- Transactions[].Receiver.Address.State
  String
  Probable
  State
- Transactions[].Receiver.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Receiver.Address.County
  String
  Possible
  County
- Transactions[].Receiver.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Receiver.EmailAddress
  String
  Probable
- Transactions[].Receiver.PhoneNumber.Office
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Receiver.PhoneNumber.Fax
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[]
  Array of Objects
  Reliable
  A collection of claims submissions from a provider for services provided to patients.
- Transactions[].Submissions[].BillingProvider
  Object
  Reliable
  Billing Provider
- Transactions[].Submissions[].BillingProvider.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Submissions[].BillingProvider.Identifiers[].ID
  String
  Reliable
  ID for the business
- Transactions[].Submissions[].BillingProvider.Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Submissions[].BillingProvider.Name
  String
  Reliable
- Transactions[].Submissions[].BillingProvider.Address
  Object
  Probable
  Address of the business
- Transactions[].Submissions[].BillingProvider.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Submissions[].BillingProvider.Address.City
  String
  Probable
  City
- Transactions[].Submissions[].BillingProvider.Address.State
  String
  Probable
  State
- Transactions[].Submissions[].BillingProvider.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Submissions[].BillingProvider.Address.County
  String
  Possible
  County
- Transactions[].Submissions[].BillingProvider.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].BillingProvider.EmailAddress
  String
  Probable
- Transactions[].Submissions[].BillingProvider.PhoneNumber.Office
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].BillingProvider.PhoneNumber.Fax
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].BillingProvider.Specialty.ID
  String
  Reliable
  Billing provider's specialty.
  Commonly the taxonomy ID
- Transactions[].Submissions[].BillingProvider.Specialty.Description
  String
  Reliable
  Billing provider's specialty description
- Transactions[].Submissions[].Subscribers[]
  Array of Objects
  Possible
  The subscriber is the individual who is contracted with the insurance plan
- Transactions[].Submissions[].Subscribers[].Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Submissions[].Subscribers[].Identifiers[].ID
  String
  Reliable
  ID for the subscriber
- Transactions[].Submissions[].Subscribers[].Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Submissions[].Subscribers[].Demographics.FirstName
  String
  Possible
  First name of the Subscriber
- Transactions[].Submissions[].Subscribers[].Demographics.MiddleName
  String
  Possible
  Middle name of the Subscriber
- Transactions[].Submissions[].Subscribers[].Demographics.LastName
  String
  Possible
  Last name of the Subscriber
- Transactions[].Submissions[].Subscribers[].Demographics.Address
  Object
  Possible
  Address of the Subscriber
- Transactions[].Submissions[].Subscribers[].Demographics.Address.StreetAddress
  String
  Possible
  Street address
- Transactions[].Submissions[].Subscribers[].Demographics.Address.City
  String
  Possible
  City
- Transactions[].Submissions[].Subscribers[].Demographics.Address.State
  String
  Possible
  State
- Transactions[].Submissions[].Subscribers[].Demographics.Address.ZIP
  String
  Possible
  ZIP
- Transactions[].Submissions[].Subscribers[].Demographics.Address.County
  String
  Possible
  County
- Transactions[].Submissions[].Subscribers[].Demographics.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Demographics.PhoneNumber.Home
  String
  Possible
  Home phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Demographics.PhoneNumber.Office
  String
  Possible
  Office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Demographics.PhoneNumber.Mobile
  String
  Probable
  Mobile phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Demographics.DOB
  String
  Reliable
  Subscriber's date of birth.
  In YYYY-MM-DD format
- Transactions[].Submissions[].Subscribers[].Demographics.Sex
  String
  Reliable
  ValueSet
  Subscriber's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].OrganizationName
  String
  Reliable
  If the subscriber is not a person, this will contain the organization name
- Transactions[].Submissions[].Subscribers[].ResponsibilityLevel
  String
  Reliable
  ValueSet
  Payor responsibility level
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Insurance
  Array of Objects
  Probable
- Transactions[].Submissions[].Subscribers[].Insurance.Plan.ID
  String
  Probable
  Identifier of insurance plan
- Transactions[].Submissions[].Subscribers[].Insurance.Plan.IDType
  String
  Probable
  ID type of insurance plan
- Transactions[].Submissions[].Subscribers[].Insurance.Plan.Name
  String
  Probable
  Name of insurance plan
- Transactions[].Submissions[].Subscribers[].Insurance.Plan.Type
  String
  Possible
  Type of insurance plan
- Transactions[].Submissions[].Subscribers[].Insurance.MemberNumber
  String
  Possible
  Patient member number
- Transactions[].Submissions[].Subscribers[].Insurance.Company.ID
  String
  Probable
  ID of insurance company (payor)
- Transactions[].Submissions[].Subscribers[].Insurance.Company.IDType
  String
  Probable
  ID type of insurance company (payor)
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Name
  String
  Probable
  Name of insurance company (payor)
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address
  Object
  Probable
  Insurance company's address
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.City
  String
  Probable
  City
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.State
  String
  Probable
  State
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.County
  String
  Possible
  County
- Transactions[].Submissions[].Subscribers[].Insurance.Company.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Insurance.Company.PhoneNumber
  String
  Probable
  Insurance companys phone number.
  In E. 164 Format (i.e. +16085551234)
- Transactions[].Submissions[].Subscribers[].Insurance.GroupNumber
  String
  Probable
  Insurance policy group number
- Transactions[].Submissions[].Subscribers[].Insurance.GroupName
  String
  Probable
  Insurance policy group name
- Transactions[].Submissions[].Subscribers[].Insurance.EffectiveDate
  String
  Probable
  Effect date of this insurance policy.
  In YYYY-MM-DD format
- Transactions[].Submissions[].Subscribers[].Insurance.ExpirationDate
  String
  Probable
  Expiration date of this insurance policy.
  In YYYY-MM-DD format
- Transactions[].Submissions[].Subscribers[].Insurance.PolicyNumber
  String
  Probable
  Insurance policy number
- Transactions[].Submissions[].Subscribers[].Insurance.Priority
  String
  Possible
  ValueSet
  The insurance priority sequence.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Insurance.AgreementType
  String
  Probable
  ValueSet
  Type of insurance agreement.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Insurance.CoverageType
  String
  Probable
  ValueSet
  Type of insurance agreement.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID types that identify the patient
- Transactions[].Submissions[].Subscribers[].Patients[].Identifiers[].ID
  String
  Reliable
  ID for the patient
- Transactions[].Submissions[].Subscribers[].Patients[].Identifiers[].IDType
  String
  Reliable
  Type of ID.
  E.g. MRN, EPI
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.FirstName
  String
  Reliable
  Patient's first name
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.MiddleName
  String
  Possible
  Patient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.LastName
  String
  Reliable
  Patient's last name
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.DOB
  String
  Reliable
  Patient's date of birth.
  In ISO 8601 format
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.SSN
  String
  Probable
  Patient's social security number
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Sex
  String
  Reliable
  ValueSet
  Patient's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Race
  String
  Possible
  ValueSet
  Patient's race
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.IsHispanic
  Boolean
  Possible
  ValueSet
  Indicates if the patient is of hispanic origin.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Religion
  String
  Possible
  ValueSet
  Patient's religious affiliation
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.MaritalStatus
  String
  Possible
  ValueSet
  Patient's marital status
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.IsDeceased
  Boolean
  Possible
  Indicates if the patient is deceased
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.DeathDateTime
  DateTime
  Possible
  Date and Time the patient was proclaimed deceased.
  ISO 8601 Format
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.PhoneNumber.Home
  String
  Probable
  Patient's home phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.PhoneNumber.Office
  String
  Probable
  Patient's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.PhoneNumber.Mobile
  String
  Probable
  Patient's mobile phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.EmailAddresses[]
  Array of Strings
  Probable
  Patient's email address(es)
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Language
  String
  Possible
  ValueSet
  Patient's primary spoken language
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Citizenship[]
  Array of strings
  Possible
  ValueSet
  Patient's nation(s) of citizenship
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address
  Object
  Probable
  Patient's home address
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.City
  String
  Probable
  City
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.State
  String
  Probable
  State
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.County
  String
  Possible
  County
- Transactions[].Submissions[].Subscribers[].Patients[].Demographics.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Notes[]
  Array of strings
  Possible
  Patient-level notes
- Transactions[].Submissions[].Subscribers[].Patients[].RelationToSubscriber
  String
  Reliable
  ValueSet
  Relation to the subscriber
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[]
  Array of Object
  Reliable
  Array of claims for the given subscriber/patient.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].SubmissionNumber
  String
  Reliable
  This will generally be the claim number sent on the initial claim submission.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Type
  String
  Probable
  ValueSet
  Type of Claim (Institutional only)
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].TotalAmount
  String
  Probable
  Total amount of all lines on the claim.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].CopayAmount
  String
  Probable
  Amount the patient has paid or still owes.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].IsProviderSignatureOnFile
  Boolean
  Probable
  Whether or not the provider signature is on file for the claim.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].IsReleaseOfInformationOnFile
  Boolean
  Probable
  Whether or not the submitter has a signed ROI form for the patient.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].ProviderAcceptanceCode
  String
  Possible
  Code indicating whether the provider accepts assignment.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].BenefitsAssignmentCode
  Boolean
  Probable
  ValueSet
  Code indicates whether the patient has or has not assigned benefits to the provider.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].AdditionalDates[]
  Array of Objects
  Probable
  Collection of additional dates related to the claim
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].AdditionalDates[].DateTime
  String
  Probable
  ISO 8601 Format
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].AdditionalDates[].Type
  String
  Probable
  Type of date value.
  e.x. Service Period Start (https://ushik.ahrq.gov/ViewItemDetails?system=sdo&itemKey=133121000)
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].ReferenceNumbers[]
  Array of Objects
  Probable
  Reference numbers associated to the claim like Prior Auth Number, Member ID, and Provider IDs
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].ReferenceNumbers[].ID
  String
  Probable
  ID for the claim
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].ReferenceNumbers[].IDType
  String
  Probable
  The type of ID
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Diagnoses[].Code
  String
  Probable
  Diagnosis code.
  First index in array indicates primary diagnosis
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Diagnoses[].Codeset
  String
  Probable
  Code set used to identify the diagnosis code.
  e.x. ICD-10, ICD-9
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Diagnoses[].Description
  String
  Probable
  Diagnosis name
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Diagnoses[].Type
  String
  Probable
  Type of diagnosis.
  One of the following: Admitting, Working, or Final
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].DiagnosisRelatedGroup
  String
  Probable
  CMS Diagnosis Related Group for an inpatient admission
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].ID
  String
  Possible
  ID of the provider.
  This ID is often required for Inpatient Visits.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].IDType
  String
  Possible
  ID type of the ID for the provider
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].FirstName
  String
  Possible
  First name of the undefined
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].LastName
  String
  Possible
  Last name of the undefined
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Credentials[]
  Array of Strings
  Possible
  List of credentials for the undefined.
  e.g. MD, PhD
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address
  Object
  Possible
  Provider's address
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.StreetAddress
  String
  Possible
  Street address
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.City
  String
  Possible
  City
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.State
  String
  Possible
  State
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.ZIP
  String
  Possible
  ZIP
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.County
  String
  Possible
  County
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].EmailAddresses[]
  Array of Strings
  Probable
  Provider's email address(es)
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].PhoneNumber.Office
  String
  Possible
  Provider's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Location
  Object
  Possible
  Provider's location
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Location.Type
  String
  Possible
  Type of location.
  Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Location.Facility
  String
  Possible
  Facility.
  Example: Community Hospital
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Location.Department
  String
  Possible
  Department
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Location.Room
  String
  Possible
  Room.
  Example: 136
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Role
  String
  Probable
  The role this provider has in patient care.
  E.x. Attending, Referring, Operating
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Specialty.ID
  String
  Probable
  ID of specialty.
  Commonly the taxonomy ID
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Providers[].Specialty.Description
  String
  Probable
  Description/name of specialty
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[]
  Array of Objects
  Reliable
  Services associated with this claim
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Code
  String
  Probable
  Code for the service line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Codeset
  String
  Probable
  Code set used to identify the service line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Description
  String
  Probable
  Description of the service line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Modifiers[]
  String
  Probable
  Array of service modifiers
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Amount
  String
  Probable
  Total dollar amount for this line item
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].StartDateTime
  String
  Probable
  When the service conveyed began
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].EndDateTime
  String
  Probable
  When the service conveyed ended
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].RevenueCode
  String
  Probable
  Institutional only.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Quantity.Value
  String
  Probable
  Service line quantity.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Quantity.Units
  String
  Probable
  Associated units to the quantity
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].IsEmergency
  Boolean
  Probable
  Whether or not this service was performed in an emergency setting.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].ReferenceNumbers[]
  Array of Objects
  Probable
  Reference numbers associated to the claim service line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].ReferenceNumbers[].ID
  String
  Probable
  ID for the service line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].ReferenceNumbers[].IDType
  String
  Probable
  The type of ID
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Diagnoses[].Code
  String
  Probable
  Diagnosis code.
  First index in array indicates primary diagnosis associated with this service line item.
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Diagnoses[].Codeset
  String
  Probable
  Code set used to identify the diagnosis code.
  e.x. ICD-10, ICD-9
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Diagnoses[].Description
  String
  Probable
  Diagnosis name
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Diagnoses[].Type
  String
  Probable
  Type of diagnosis.
  One of the following: Admitting, Working, or Final
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Drug
  Object
  Probable
  Drug information related to the service of an institutional claim
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Drug.PrescriptionID
  String
  Probable
  Pharmacy Prescription ID associated to the the drug
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Drug.NDC
  String
  Probable
  NDC ID
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Drug.Quantity.Value
  String
  Probable
  Drug Quantity
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Drug.Quantity.Units
  String
  Probable
  Associated Units to the quantity
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Services[].Notes
  String
  Probable
  Additional notes for this line
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.DateTime
  String
  Probable
  DateTime of admission.
  ISO 8601 Format
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.DischargeDateTime
  String
  Probable
  DateTime of discharge.
  ISO 8601 Format
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Location
  Object
  Probable
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Location.Type
  String
  Probable
  Type of location.
  Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Location.Facility
  String
  Probable
  Facility.
  Example: Community Hospital
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Location.Department
  String
  Probable
  Department
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Location.Room
  String
  Probable
  Room.
  Example: 136
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.PreviousLocation
  Object
  Probable
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.PreviousLocation.Type
  String
  Probable
  Type of location.
  Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.PreviousLocation.Facility
  String
  Probable
  Facility.
  Example: Community Hospital
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.PreviousLocation.Department
  String
  Probable
  Department
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.PreviousLocation.Room
  String
  Probable
  Room.
  Example: 136
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.Type
  String
  Probable
  Type of inpatient admission.
  Only populated for inpatient admissions. E.x. Elective, Emergency
- Transactions[].Submissions[].Subscribers[].Patients[].Claims[].Visit.VisitNumber
  String
  Possible
  Visit Number.
  Unique ID of a single visit

Sample MessageDownload JSON Schema

{
   "Meta": {
      "DataModel": "Claim",
      "EventType": "SubmissionBatch",
      "EventDateTime": "2022-06-30T16:07:58.135Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Logs": [
         {
            "ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
            "AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Transactions": [
      {
         "ID": "000000001",
         "IDType": null,
         "Type": "Institutional",
         "Submitter": {
            "Identifiers": [
               {
                  "ID": "8675309",
                  "IDType": "TIN"
               }
            ],
            "Name": "Redox Health System",
            "Address": {
               "StreetAddress": null,
               "City": null,
               "State": null,
               "ZIP": null,
               "County": null,
               "Country": null
            },
            "EmailAddress": null,
            "PhoneNumber": {
               "Office": null,
               "Fax": null
            }
         },
         "Receiver": {
            "Identifiers": [
               {
                  "ID": "123456",
                  "IDType": "TIN"
               }
            ],
            "Name": "National Insurance Company of Redox",
            "Address": {
               "StreetAddress": null,
               "City": null,
               "State": null,
               "ZIP": null,
               "County": null,
               "Country": null
            },
            "EmailAddress": null,
            "PhoneNumber": {
               "Office": null,
               "Fax": null
            }
         },
         "Submissions": [
            {
               "BillingProvider": {
                  "Identifiers": [],
                  "Name": null,
                  "Address": {
                     "StreetAddress": null,
                     "City": null,
                     "State": null,
                     "ZIP": null,
                     "County": null,
                     "Country": null
                  },
                  "EmailAddress": null,
                  "PhoneNumber": {
                     "Office": null,
                     "Fax": null
                  },
                  "Specialty": {
                     "ID": null,
                     "Description": null
                  }
               },
               "Subscribers": [
                  {
                     "Identifiers": [
                        {
                           "ID": "0000000001",
                           "IDType": "MR"
                        },
                        {
                           "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                           "IDType": "EHRID"
                        },
                        {
                           "ID": "a1d4ee8aba494ca",
                           "IDType": "NIST"
                        }
                     ],
                     "Demographics": {
                        "FirstName": "Timothy",
                        "MiddleName": "Paul",
                        "LastName": "Bixby",
                        "Address": {
                           "StreetAddress": "4762 Hickory Street",
                           "City": "Monroe",
                           "State": "WI",
                           "ZIP": "53566",
                           "County": "Green",
                           "Country": "US"
                        },
                        "PhoneNumber": {
                           "Home": "+18088675301",
                           "Office": null,
                           "Mobile": null
                        },
                        "DOB": "2008-01-06",
                        "Sex": "Male"
                     },
                     "OrganizationName": null,
                     "ResponsibilityLevel": "Primary",
                     "Insurance": {
                        "Plan": {
                           "ID": "31572",
                           "IDType": "Payor ID",
                           "Name": "HMO Deductible Plan",
                           "Type": null
                        },
                        "MemberNumber": null,
                        "Company": {
                           "ID": "60054",
                           "IDType": null,
                           "Name": "aetna (60054 0131)",
                           "Address": {
                              "StreetAddress": "PO Box 14080",
                              "City": "Lexington",
                              "State": "KY",
                              "ZIP": "40512-4079",
                              "County": "Fayette",
                              "Country": "US"
                           },
                           "PhoneNumber": "+18089541123"
                        },
                        "GroupNumber": "847025-024-0009",
                        "GroupName": "Accelerator Labs",
                        "EffectiveDate": "2015-01-01",
                        "ExpirationDate": "2020-12-31",
                        "PolicyNumber": "9140860055",
                        "Priority": null,
                        "AgreementType": null,
                        "CoverageType": null
                     },
                     "Patients": [
                        {
                           "Identifiers": [
                              {
                                 "ID": "0000000001",
                                 "IDType": "MR"
                              },
                              {
                                 "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                                 "IDType": "EHRID"
                              },
                              {
                                 "ID": "a1d4ee8aba494ca",
                                 "IDType": "NIST"
                              }
                           ],
                           "Demographics": {
                              "FirstName": "Timothy",
                              "MiddleName": "Paul",
                              "LastName": "Bixby",
                              "DOB": "2008-01-06",
                              "SSN": "101-01-0001",
                              "Sex": "Male",
                              "Race": "White",
                              "IsHispanic": null,
                              "Religion": null,
                              "MaritalStatus": "Single",
                              "IsDeceased": null,
                              "DeathDateTime": null,
                              "PhoneNumber": {
                                 "Home": "+18088675301",
                                 "Office": null,
                                 "Mobile": null
                              },
                              "EmailAddresses": [],
                              "Language": "en",
                              "Citizenship": [],
                              "Address": {
                                 "StreetAddress": "4762 Hickory Street",
                                 "City": "Monroe",
                                 "State": "WI",
                                 "ZIP": "53566",
                                 "County": "Green",
                                 "Country": "US"
                              }
                           },
                           "Notes": [],
                           "RelationToSubscriber": null,
                           "Claims": [
                              {
                                 "SubmissionNumber": "66729659983",
                                 "Type": "Admit Through Discharge",
                                 "TotalAmount": "200.00",
                                 "CopayAmount": "10.00",
                                 "IsProviderSignatureOnFile": true,
                                 "IsReleaseOfInformationOnFile": true,
                                 "ProviderAcceptanceCode": null,
                                 "BenefitsAssignmentCode": null,
                                 "AdditionalDates": [
                                    {
                                       "DateTime": "2016-10-08",
                                       "Type": "Service Period Start"
                                    },
                                    {
                                       "DateTime": "2016-10-11",
                                       "Type": "Service Period End"
                                    }
                                 ],
                                 "ReferenceNumbers": [
                                    {
                                       "ID": "AUTH000000",
                                       "IDType": "Prior Authorization"
                                    }
                                 ],
                                 "Diagnoses": [
                                    {
                                       "Code": "M54.5",
                                       "Codeset": "ICD-10",
                                       "Description": null,
                                       "Type": "Admitting"
                                    },
                                    {
                                       "Code": "J45.909",
                                       "Codeset": "ICD-10",
                                       "Description": null,
                                       "Type": null
                                    }
                                 ],
                                 "DiagnosisRelatedGroup": "551",
                                 "Providers": [
                                    {
                                       "ID": "4236464757",
                                       "IDType": "NPI",
                                       "FirstName": "John",
                                       "LastName": "Slate",
                                       "Credentials": [
                                          "DO"
                                       ],
                                       "Address": {
                                          "StreetAddress": "500 First St.",
                                          "City": "Clayton",
                                          "State": "MO",
                                          "ZIP": "63105",
                                          "County": "Saint Louis",
                                          "Country": "USA"
                                       },
                                       "EmailAddresses": [],
                                       "PhoneNumber": {
                                          "Office": null
                                       },
                                       "Location": {
                                          "Type": null,
                                          "Facility": null,
                                          "Department": null,
                                          "Room": null
                                       },
                                       "Role": "Attending",
                                       "Specialty": {
                                          "ID": "1223G0001X",
                                          "Description": "General Practice"
                                       }
                                    }
                                 ],
                                 "Services": [
                                    {
                                       "Code": "73560",
                                       "Codeset": null,
                                       "Description": "X-Ray knee 1 or 2 views",
                                       "Modifiers": [],
                                       "Amount": "100.00",
                                       "StartDateTime": null,
                                       "EndDateTime": null,
                                       "RevenueCode": null,
                                       "Quantity": {
                                          "Value": 1,
                                          "Units": "Unit"
                                       },
                                       "IsEmergency": false,
                                       "ReferenceNumbers": [
                                          {
                                             "ID": "1",
                                             "IDType": "Control Number"
                                          }
                                       ],
                                       "Diagnoses": [],
                                       "Drug": {
                                          "PrescriptionID": null,
                                          "NDC": null,
                                          "Quantity": {
                                             "Value": null,
                                             "Units": null
                                          }
                                       },
                                       "Notes": null
                                    },
                                    {
                                       "Code": "J9202",
                                       "Codeset": "HCPCS",
                                       "Description": "Zoladex",
                                       "Modifiers": [],
                                       "Amount": "3.50",
                                       "StartDateTime": null,
                                       "EndDateTime": null,
                                       "RevenueCode": null,
                                       "Quantity": {
                                          "Value": "1",
                                          "Units": "Unit"
                                       },
                                       "IsEmergency": false,
                                       "ReferenceNumbers": [
                                          {
                                             "ID": "2",
                                             "IDType": "Control Number"
                                          }
                                       ],
                                       "Diagnoses": [],
                                       "Drug": {
                                          "PrescriptionID": "ABC123456",
                                          "NDC": "00310095036",
                                          "Quantity": {
                                             "Value": "1",
                                             "Units": "Unit"
                                          }
                                       },
                                       "Notes": null
                                    }
                                 ],
                                 "Visit": {
                                    "DateTime": "2016-10-08",
                                    "DischargeDateTime": "2016-10-11",
                                    "Location": {
                                       "Type": "Inpatient",
                                       "Facility": "RES General Hospital",
                                       "Department": "3N",
                                       "Room": "136"
                                    },
                                    "PreviousLocation": {
                                       "Type": "Critical Access Hospital",
                                       "Facility": null,
                                       "Department": null,
                                       "Room": null
                                    },
                                    "Type": "Elective",
                                    "VisitNumber": null
                                 }
                              }
                           ]
                        }
                     ]
                  }
               ]
            }
         ]
      }
   ]
}

PaymentBatch

DEV PREVIEW

A PaymentBatch message is used to send a payment notification, typically from a payer to a healthcare provider, but it may be used in other situations where funds are transferred from one party to another. This is functionally identical to the Payment Event, but allows for multiple transactions to be sent in a batch.

Fields

Show Required Fields Only

Show Translation Fields

Meta
- Meta.DataModel
  String
  Reliable
  Required
  Claim
- Meta.EventType
  String
  Reliable
  Required
  PaymentBatch
- Meta.EventDateTime
  DateTime
  Reliable
  DateTime of the event.
  ISO 8601 Format
- Meta.Test
  Boolean
  Reliable
  Flag as a test message
- Meta.Source
  String
  Reliable
  Where the message originated.
  Included in messages from Redox
- Meta.Source.ID
  String
  Reliable
  ID of the source.
  UUID
- Meta.Source.Name
  String
  Reliable
  Name of the source
- Meta.Destinations[]
  Array of Objects
  Reliable
  List of destinations to send your message to. All messages must have at least one destination. Queries accept only one destination.
  Required when sending data to Redox
- Meta.Destinations[].ID
  String
  Reliable
  ID of the destination.
  UUID
- Meta.Destinations[].Name
  String
  Reliable
  Name of the destination
- Meta.Logs[]
  Array of Objects
  Reliable
  Request log identifiers.
- Meta.Logs[].ID
  String
  Reliable
  ID of a request log that corresponds to this request, used for support and reference within the Redox dashboard.
  UUID
- Meta.Logs[].AttemptID
  String
  Reliable
  ID of request log attempt. Useful in cases where retries are possible.
  UUID
- Meta.Message
  String
  Reliable
  Record in Redox that corresponds to the communication sent from the source to Redox.
  Included in messages from Redox
- Meta.Message.ID
  Numeric
  Reliable
  ID of the message created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.Transmission
  String
  Reliable
  Record in Redox that corresponds to the communication sent from Redox to your destination.
  Included in messages from Redox
- Meta.Transmission.ID
  Numeric
  Reliable
  ID of the transmission created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.FacilityCode
  String
  Possible
  Code for the facility related to the message.
  Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Transactions
- Transactions[].ID
  String
  Reliable
  ID used by submitter to reference this Claims
- Transactions[].IDType
  String
  Reliable
  Type of ID
- Transactions[].Type
  String
  Reliable
  ValueSet
  The type of Claims, Institutional or Professional
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].TotalPaymentAmount
  String
  Probable
  The total amount of all of the payments listed in the Payments array.
  Redox recommends sending it as an additional layer of validation.
- Transactions[].CreditOrDebit
  String
  Probable
  ValueSet
  A flag indicating whether the monetary amount in Transaction.TotalPaymentAmount is a credit or debit.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].PaymentMethod
  String
  Probable
  ValueSet
  How the payment was/will be transferred.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].PaymentDateTime
  String
  Probable
  When the transaction should be processed by the destination.
  For example, if the "Check" is used in Transaction.PaymentMethod this would be the date on the check. ISO 8601 Format
- Transactions[].TrackingNumber
  String
  Probable
  A number used to by the Payer to trace the payment.
  For example, if the "Check" is used in Transaction.PaymentMethod this would be the check number.
- Transactions[].Submitter
  Object
  Reliable
  Submitter of a Claims
- Transactions[].Submitter.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Submitter.Identifiers[].ID
  String
  Reliable
  ID for the submitter
- Transactions[].Submitter.Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Submitter.Name
  String
  Reliable
- Transactions[].Submitter.Address
  Object
  Probable
  Address of the Submitter
- Transactions[].Submitter.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Submitter.Address.City
  String
  Probable
  City
- Transactions[].Submitter.Address.State
  String
  Probable
  State
- Transactions[].Submitter.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Submitter.Address.County
  String
  Possible
  County
- Transactions[].Submitter.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Submitter.EmailAddress
  String
  Probable
- Transactions[].Submitter.PhoneNumber.Office
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Submitter.PhoneNumber.Fax
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Receiver
  Object
  Reliable
  Receiver of a Claims
- Transactions[].Receiver.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID Types that identify the concept
- Transactions[].Receiver.Identifiers[].ID
  String
  Reliable
  ID for the receiver
- Transactions[].Receiver.Identifiers[].IDType
  String
  Reliable
  The type of ID
- Transactions[].Receiver.Name
  String
  Reliable
- Transactions[].Receiver.Address
  Object
  Probable
  Address of the Receiver
- Transactions[].Receiver.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Receiver.Address.City
  String
  Probable
  City
- Transactions[].Receiver.Address.State
  String
  Probable
  State
- Transactions[].Receiver.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Receiver.Address.County
  String
  Possible
  County
- Transactions[].Receiver.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Receiver.EmailAddress
  String
  Probable
- Transactions[].Receiver.PhoneNumber.Office
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Receiver.PhoneNumber.Fax
  String
  Probable
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Payments[]
  Array of Objects
  Probable
- Transactions[].Payments[].DateTime
  String
  Probable
  The DateTime this payment was processed.
  ISO 8601 Format
- Transactions[].Payments[].Patient.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID types that identify the patient
- Transactions[].Payments[].Patient.Identifiers[].ID
  String
  Reliable
  ID for the patient
- Transactions[].Payments[].Patient.Identifiers[].IDType
  String
  Reliable
  Type of ID.
  E.g. MRN, EPI
- Transactions[].Payments[].Patient.Demographics.FirstName
  String
  Reliable
  Patient's first name
- Transactions[].Payments[].Patient.Demographics.MiddleName
  String
  Possible
  Patient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
- Transactions[].Payments[].Patient.Demographics.LastName
  String
  Reliable
  Patient's last name
- Transactions[].Payments[].Patient.Demographics.DOB
  String
  Reliable
  Patient's date of birth.
  In ISO 8601 format
- Transactions[].Payments[].Patient.Demographics.SSN
  String
  Probable
  Patient's social security number
- Transactions[].Payments[].Patient.Demographics.Sex
  String
  Reliable
  ValueSet
  Patient's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.Race
  String
  Possible
  ValueSet
  Patient's race
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.IsHispanic
  Boolean
  Possible
  ValueSet
  Indicates if the patient is of hispanic origin.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.Religion
  String
  Possible
  ValueSet
  Patient's religious affiliation
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.MaritalStatus
  String
  Possible
  ValueSet
  Patient's marital status
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.IsDeceased
  Boolean
  Possible
  Indicates if the patient is deceased
- Transactions[].Payments[].Patient.Demographics.DeathDateTime
  DateTime
  Possible
  Date and Time the patient was proclaimed deceased.
  ISO 8601 Format
- Transactions[].Payments[].Patient.Demographics.PhoneNumber.Home
  String
  Probable
  Patient's home phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Payments[].Patient.Demographics.PhoneNumber.Office
  String
  Probable
  Patient's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Payments[].Patient.Demographics.PhoneNumber.Mobile
  String
  Probable
  Patient's mobile phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transactions[].Payments[].Patient.Demographics.EmailAddresses[]
  Array of Strings
  Probable
  Patient's email address(es)
- Transactions[].Payments[].Patient.Demographics.Language
  String
  Possible
  ValueSet
  Patient's primary spoken language
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.Citizenship[]
  Array of strings
  Possible
  ValueSet
  Patient's nation(s) of citizenship
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Demographics.Address
  Object
  Probable
  Patient's home address
- Transactions[].Payments[].Patient.Demographics.Address.StreetAddress
  String
  Probable
  Street address
- Transactions[].Payments[].Patient.Demographics.Address.City
  String
  Probable
  City
- Transactions[].Payments[].Patient.Demographics.Address.State
  String
  Probable
  State
- Transactions[].Payments[].Patient.Demographics.Address.ZIP
  String
  Probable
  ZIP
- Transactions[].Payments[].Patient.Demographics.Address.County
  String
  Possible
  County
- Transactions[].Payments[].Patient.Demographics.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Patient.Notes[]
  Array of strings
  Possible
  Patient-level notes
- Transactions[].Payments[].Claims[]
  Array of Objects
  Probable
- Transactions[].Payments[].Claims[].ControlNumber
  String
  Reliable
  The Payer's reference number
- Transactions[].Payments[].Claims[].SubmissionNumber
  String
  Reliable
  This will generally be the claim number sent on the initial claim submission.
- Transactions[].Payments[].Claims[].ReceivedDate
  String
  Probable
  Date the claim was submitted.
  ISO 8601 Format
- Transactions[].Payments[].Claims[].StartDateTime
  String
  Probable
  Date the statement period started.
  ISO 8601 Format
- Transactions[].Payments[].Claims[].EndDateTime
  String
  Probable
  Date the statement period ended.
  ISO 8601 Format
- Transactions[].Payments[].Claims[].Status
  String
  Reliable
  ValueSet
  Status of the claim
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Claims[].ChargedAmount
  String
  Reliable
  Total monetary amount of the claim
- Transactions[].Payments[].Claims[].PaymentAmount
  String
  Probable
  Monetary amount of the claim paid
- Transactions[].Payments[].Claims[].PatientResponsibilityAmount
  String
  Reliable
  Monetary amount of the claim the patient is responsible for
- Transactions[].Payments[].Claims[].ReferenceNumbers[]
  Array of Objects
  Probable
  Reference numbers associated to the claim like Prior Auth Number, Member ID, and Provider IDs
- Transactions[].Payments[].Claims[].ReferenceNumbers[].ID
  String
  Probable
  ID for the claim
- Transactions[].Payments[].Claims[].ReferenceNumbers[].IDType
  String
  Probable
  The type of ID
- Transactions[].Payments[].Claims[].Adjustments[]
  Object
  Reliable
  Adjustments explain why a claim was paid differently than it was billed.
  Adjustments may not exist at the claim level if they exist at the service level
- Transactions[].Payments[].Claims[].Adjustments[].Amount
  String
  Probable
  Monetary amount of the adjustment.
  A negative number indicates a payment increase, while a positive number indicates a payment reduction.
- Transactions[].Payments[].Claims[].Adjustments[].Quantity
  String
  Probable
- Transactions[].Payments[].Claims[].Adjustments[].Type
  String
  Probable
  ValueSet
  Type of Adjustment
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Claims[].Adjustments[].Reason
  String
  Probable
  ValueSet
  Adjustment reason
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Claims[].Services[]
  String
  Probable
  This array will provide additional detail for claims processed at the line level.
- Transactions[].Payments[].Claims[].Services[].ChargedAmount
  String
  Probable
  The monetory amount charged
- Transactions[].Payments[].Claims[].Services[].PaymentAmount
  String
  Reliable
  The monetory amount paid
- Transactions[].Payments[].Claims[].Services[].ChargedUnits
  String
  Probable
  The number of units of service charged for
- Transactions[].Payments[].Claims[].Services[].PaymentUnits
  String
  Probable
  The number of units of service paid for
- Transactions[].Payments[].Claims[].Services[].AllowedAmount
  String
  Reliable
  Maximum monetary amount of payment
- Transactions[].Payments[].Claims[].Services[].SubmittedService
  Object
  Probable
  Submitted service information
- Transactions[].Payments[].Claims[].Services[].SubmittedService.Code
  String
  Probable
  Code for the submitted service
- Transactions[].Payments[].Claims[].Services[].SubmittedService.Codeset
  String
  Probable
  Code set used to identify the submitted service
- Transactions[].Payments[].Claims[].Services[].SubmittedService.Description
  String
  Probable
  Description of the submitted service
- Transactions[].Payments[].Claims[].Services[].SubmittedService.Modifiers[]
  String
  Probable
  Array of modifiers
- Transactions[].Payments[].Claims[].Services[].AdjudicatedService
  Object
  Probable
  Adjudicated service information
- Transactions[].Payments[].Claims[].Services[].AdjudicatedService.Code
  String
  Probable
  Code for the adjudicated service
- Transactions[].Payments[].Claims[].Services[].AdjudicatedService.Codeset
  String
  Probable
  Code set used to identify the adjudicated service
- Transactions[].Payments[].Claims[].Services[].AdjudicatedService.Description
  String
  Probable
  Description of the adjudicated service
- Transactions[].Payments[].Claims[].Services[].AdjudicatedService.Modifiers[]
  String
  Probable
  Array of modifiers
- Transactions[].Payments[].Claims[].Services[].Adjustments[]
  Object
  Reliable
  Adjustments explain why a claim was paid differently than it was billed.
- Transactions[].Payments[].Claims[].Services[].Adjustments[].Amount
  String
  Probable
  Monetary amount of the adjustment.
  A negative number indicates a payment increase, while a positive number indicates a payment reduction.
- Transactions[].Payments[].Claims[].Services[].Adjustments[].Quantity
  String
  Probable
- Transactions[].Payments[].Claims[].Services[].Adjustments[].Type
  String
  Probable
  ValueSet
  Type of Adjustment
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Claims[].Services[].Adjustments[].Reason
  String
  Probable
  ValueSet
  Adjustment reason
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Transactions[].Payments[].Claims[].Services[].StartDateTime
  String
  Probable
  Date the claim was submitted.
  ISO 8601 Format
- Transactions[].Payments[].Claims[].Services[].EndDateTime
  String
  Probable
  Date the statement period started.
  ISO 8601 Format
- Transactions[].Payments[].Claims[].Services[].ReferenceNumbers[]
  Array of Objects
  Probable
  Reference numbers associated to the claim service line
- Transactions[].Payments[].Claims[].Services[].ReferenceNumbers[].ID
  String
  Probable
  ID for the service line
- Transactions[].Payments[].Claims[].Services[].ReferenceNumbers[].IDType
  String
  Probable
  The type of ID

Sample MessageDownload JSON Schema

{
   "Meta": {
      "DataModel": "Claim",
      "EventType": "PaymentBatch",
      "EventDateTime": "2022-06-30T16:07:58.135Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Logs": [
         {
            "ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
            "AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Transactions": [
      {
         "ID": "000000001",
         "IDType": null,
         "Type": "Profressional",
         "TotalPaymentAmount": "580.00",
         "CreditOrDebit": "Credit",
         "PaymentMethod": "Check",
         "PaymentDateTime": "2016-11-11T02:11:03.111Z",
         "TrackingNumber": "8675309",
         "Submitter": {
            "Identifiers": [
               {
                  "ID": "123456",
                  "IDType": "TIN"
               }
            ],
            "Name": "National Insurance Company of Redox",
            "Address": {
               "StreetAddress": null,
               "City": null,
               "State": null,
               "ZIP": null,
               "County": null,
               "Country": null
            },
            "EmailAddress": null,
            "PhoneNumber": {
               "Office": null,
               "Fax": null
            }
         },
         "Receiver": {
            "Identifiers": [
               {
                  "ID": "8675309",
                  "IDType": "TIN"
               }
            ],
            "Name": "Redox Health System",
            "Address": {
               "StreetAddress": null,
               "City": null,
               "State": null,
               "ZIP": null,
               "County": null,
               "Country": null
            },
            "EmailAddress": null,
            "PhoneNumber": {
               "Office": null,
               "Fax": null
            }
         },
         "Payments": [
            {
               "DateTime": "2016-11-08T02:11:03.111Z",
               "Patient": {
                  "Identifiers": [
                     {
                        "ID": "0000000001",
                        "IDType": "MR"
                     },
                     {
                        "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                        "IDType": "EHRID"
                     },
                     {
                        "ID": "a1d4ee8aba494ca",
                        "IDType": "NIST"
                     }
                  ],
                  "Demographics": {
                     "FirstName": "Timothy",
                     "MiddleName": "Paul",
                     "LastName": "Bixby",
                     "DOB": "2008-01-06",
                     "SSN": "101-01-0001",
                     "Sex": "Male",
                     "Race": "White",
                     "IsHispanic": null,
                     "Religion": null,
                     "MaritalStatus": "Single",
                     "IsDeceased": null,
                     "DeathDateTime": null,
                     "PhoneNumber": {
                        "Home": "+18088675301",
                        "Office": null,
                        "Mobile": null
                     },
                     "EmailAddresses": [],
                     "Language": "en",
                     "Citizenship": [],
                     "Address": {
                        "StreetAddress": "4762 Hickory Street",
                        "City": "Monroe",
                        "State": "WI",
                        "ZIP": "53566",
                        "County": "Green",
                        "Country": "US"
                     }
                  },
                  "Notes": []
               },
               "Claims": [
                  {
                     "ControlNumber": "94151100100",
                     "SubmissionNumber": "66729659983",
                     "ReceivedDate": "2016-10-31",
                     "StartDateTime": null,
                     "EndDateTime": null,
                     "Status": "Processed as Primary",
                     "ChargedAmount": "100.00",
                     "PaymentAmount": "65.00",
                     "PatientResponsibilityAmount": "20.00",
                     "ReferenceNumbers": [
                        {
                           "ID": "AUTH000000",
                           "IDType": "Prior Authorization"
                        }
                     ],
                     "Adjustments": [],
                     "Services": [
                        {
                           "ChargedAmount": "100.00",
                           "PaymentAmount": "65.00",
                           "ChargedUnits": null,
                           "PaymentUnits": null,
                           "AllowedAmount": "85.00",
                           "SubmittedService": {
                              "Code": null,
                              "Codeset": null,
                              "Description": null,
                              "Modifiers": []
                           },
                           "AdjudicatedService": {
                              "Code": null,
                              "Codeset": null,
                              "Description": null,
                              "Modifiers": []
                           },
                           "Adjustments": [
                              {
                                 "Amount": "20.00",
                                 "Quantity": null,
                                 "Type": "Patient responsibility",
                                 "Reason": "Deductible amount"
                              },
                              {
                                 "Amount": "15.00",
                                 "Quantity": null,
                                 "Type": "Contractual obligations",
                                 "Reason": "Claim specific negotiated discount"
                              }
                           ],
                           "StartDateTime": null,
                           "EndDateTime": null,
                           "ReferenceNumbers": [
                              {
                                 "ID": "1",
                                 "IDType": "Control Number"
                              }
                           ]
                        }
                     ]
                  }
               ]
            },
            {
               "DateTime": "2016-11-08T02:11:03.111Z",
               "Patient": {
                  "Identifiers": [
                     {
                        "ID": "0000000001",
                        "IDType": "MR"
                     },
                     {
                        "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                        "IDType": "EHRID"
                     },
                     {
                        "ID": "a1d4ee8aba494ca",
                        "IDType": "NIST"
                     }
                  ],
                  "Demographics": {
                     "FirstName": "Timothy",
                     "MiddleName": "Paul",
                     "LastName": "Bixby",
                     "DOB": "2008-01-06",
                     "SSN": "101-01-0001",
                     "Sex": "Male",
                     "Race": "White",
                     "IsHispanic": null,
                     "Religion": null,
                     "MaritalStatus": "Single",
                     "IsDeceased": null,
                     "DeathDateTime": null,
                     "PhoneNumber": {
                        "Home": "+18088675301",
                        "Office": null,
                        "Mobile": null
                     },
                     "EmailAddresses": [],
                     "Language": "en",
                     "Citizenship": [],
                     "Address": {
                        "StreetAddress": "4762 Hickory Street",
                        "City": "Monroe",
                        "State": "WI",
                        "ZIP": "53566",
                        "County": "Green",
                        "Country": "US"
                     }
                  },
                  "Notes": []
               },
               "Claims": [
                  {
                     "ControlNumber": "94151100200",
                     "SubmissionNumber": "774466586",
                     "ReceivedDate": "2016-10-31",
                     "StartDateTime": null,
                     "EndDateTime": null,
                     "Status": "Processed as Primary",
                     "ChargedAmount": "100.00",
                     "PaymentAmount": "75.00",
                     "PatientResponsibilityAmount": "20.00",
                     "ReferenceNumbers": [
                        {
                           "ID": "AUTH000000",
                           "IDType": "Prior Authorization"
                        }
                     ],
                     "Adjustments": [],
                     "Services": [
                        {
                           "ChargedAmount": "100.00",
                           "PaymentAmount": "75.00",
                           "ChargedUnits": null,
                           "PaymentUnits": null,
                           "AllowedAmount": "95.00",
                           "SubmittedService": {
                              "Code": null,
                              "Codeset": null,
                              "Description": null,
                              "Modifiers": []
                           },
                           "AdjudicatedService": {
                              "Code": null,
                              "Codeset": null,
                              "Description": null,
                              "Modifiers": []
                           },
                           "Adjustments": [
                              {
                                 "Amount": "20.00",
                                 "Quantity": null,
                                 "Type": "Patient responsibility",
                                 "Reason": "Deductible amount"
                              },
                              {
                                 "Amount": "5.00",
                                 "Quantity": null,
                                 "Type": "Contractual obligations",
                                 "Reason": "Claim specific negotiated discount"
                              }
                           ],
                           "StartDateTime": null,
                           "EndDateTime": null,
                           "ReferenceNumbers": [
                              {
                                 "ID": "1",
                                 "IDType": "Control Number"
                              }
                           ]
                        }
                     ]
                  }
               ]
            }
         ]
      }
   ]
}

Submission

BETA

A Submission message is used to send a payment request, typically from a healthcare provider to an insurer. This is commonly sent as an EDI 837 form by healthcare providers.

Fields

Show Required Fields Only

Show Translation Fields

Meta
- Meta.DataModel
  String
  Reliable
  Required
  Claim
- Meta.EventType
  String
  Reliable
  Required
  Submission
- Meta.EventDateTime
  DateTime
  Reliable
  DateTime of the event.
  ISO 8601 Format
- Meta.Test
  Boolean
  Reliable
  Flag as a test message
- Meta.Source
  String
  Reliable
  Where the message originated.
  Included in messages from Redox
- Meta.Source.ID
  String
  Reliable
  ID of the source.
  UUID
- Meta.Source.Name
  String
  Reliable
  Name of the source
- Meta.Destinations[]
  Array of Objects
  Reliable
  List of destinations to send your message to. All messages must have at least one destination. Queries accept only one destination.
  Required when sending data to Redox
- Meta.Destinations[].ID
  String
  Reliable
  ID of the destination.
  UUID
- Meta.Destinations[].Name
  String
  Reliable
  Name of the destination
- Meta.Logs[]
  Array of Objects
  Reliable
  Request log identifiers.
- Meta.Logs[].ID
  String
  Reliable
  ID of a request log that corresponds to this request, used for support and reference within the Redox dashboard.
  UUID
- Meta.Logs[].AttemptID
  String
  Reliable
  ID of request log attempt. Useful in cases where retries are possible.
  UUID
- Meta.Message
  String
  Reliable
  Record in Redox that corresponds to the communication sent from the source to Redox.
  Included in messages from Redox
- Meta.Message.ID
  Numeric
  Reliable
  ID of the message created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.Transmission
  String
  Reliable
  Record in Redox that corresponds to the communication sent from Redox to your destination.
  Included in messages from Redox
- Meta.Transmission.ID
  Numeric
  Reliable
  ID of the transmission created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.FacilityCode
  String
  Possible
  Code for the facility related to the message.
  Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Transaction
- Transaction.ID
  String
  Reliable
  ID used by Sender to reference this claim
- Transaction.IDType
  String
  Reliable
  Type of ID
- Transaction.Type
  String
  Reliable
  The type of claim, Institutional or Professional.
- Transaction.Submitter.ID
  String
  Reliable
  ID of the submitter
- Transaction.Submitter.IDType
  String
  Reliable
  Type of ID
- Transaction.Submitter.Name
  String
  Reliable
  Name of submitter
- Transaction.Submitter.EmailAddress
  String
  Reliable
  Email address
- Transaction.Submitter.PhoneNumber.Office
  String
  Reliable
  Submitter's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transaction.Submitter.PhoneNumber.Fax
  String
  Reliable
  Submitter's fax number.
  In E. 164 Format. (e.g. +16085551234)
- Transaction.Receiver.ID
  String
  Reliable
  ID of transaction recipient
- Transaction.Receiver.IDType
  String
  Reliable
  Type of ID
- Transaction.Receiver.Name
  String
  Reliable
  Name of transaction recipient
BillingProvider
- BillingProvider.ID
  String
  Reliable
  ID of billing provider
- BillingProvider.IDType
  String
  Reliable
  Type of ID
- BillingProvider.TIN
  String
  Possible
  Tax Identification Number of Billing Provider
- BillingProvider.FirstName
  String
  Reliable
- BillingProvider.MiddleName
  String
  Reliable
- BillingProvider.LastName
  String
  Reliable
- BillingProvider.OrganizationName
  String
  Reliable
- BillingProvider.Specialty.ID
  String
  Reliable
  Billing provider's specialty.
  Commonly the taxonomy ID
- BillingProvider.Specialty.Description
  String
  Reliable
  Billing provider's specialty description
- BillingProvider.Address
  Object
  Possible
  Billing provider's address
- BillingProvider.Address.StreetAddress
  String
  Possible
  Street address
- BillingProvider.Address.City
  String
  Possible
  City
- BillingProvider.Address.State
  String
  Possible
  State
- BillingProvider.Address.ZIP
  String
  Possible
  ZIP
- BillingProvider.Address.County
  String
  Possible
  County
- BillingProvider.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- BillingProvider.EmailAddress
  String
  Reliable
- BillingProvider.PhoneNumber.Office
  String
  Reliable
  Billing provider's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- BillingProvider.PhoneNumber.Fax
  String
  Reliable
  Billing provider's fax number.
  In E. 164 Format. (e.g. +16085551234)
Subscriber
- Subscriber.ID
  String
  Reliable
  ID of the subscriber
- Subscriber.IDType
  String
  Reliable
  Type of ID
- Subscriber.FirstName
  String
  Reliable
- Subscriber.MiddleName
  String
  Reliable
- Subscriber.LastName
  String
  Reliable
- Subscriber.OrganizationName
  String
  Reliable
  If the subscriber is not a person, this will contain the organization name
- Subscriber.Address
  Object
  Possible
  Subscriber's address
- Subscriber.Address.StreetAddress
  String
  Possible
  Street address
- Subscriber.Address.City
  String
  Possible
  City
- Subscriber.Address.State
  String
  Possible
  State
- Subscriber.Address.ZIP
  String
  Possible
  ZIP
- Subscriber.Address.County
  String
  Possible
  County
- Subscriber.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Subscriber.DOB
  String
  Reliable
  Subscriber's date of birth.
  In YYYY-MM-DD format
- Subscriber.Sex
  String
  Reliable
  ValueSet
  Subscriber's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Subscriber.RelationToPatient
  String
  Reliable
  Relation to the patient.
  E.x. Self, Parent
- Subscriber.ResponsibilityLevel
  String
  Reliable
  Payor responsibility level.
  E.x. Primary, Secondary, Tertiary
- Subscriber.Insurance
  Array of Objects
  Probable
- Subscriber.Insurance.Plan.ID
  String
  Probable
  Identifier of insurance plan
- Subscriber.Insurance.Plan.IDType
  String
  Probable
  ID type of insurance plan
- Subscriber.Insurance.Plan.Name
  String
  Probable
  Name of insurance plan
- Subscriber.Insurance.Plan.Type
  String
  Possible
  Type of insurance plan
- Subscriber.Insurance.MemberNumber
  String
  Possible
  Patient member number
- Subscriber.Insurance.Company.ID
  String
  Probable
  ID of insurance company (payor)
- Subscriber.Insurance.Company.IDType
  String
  Probable
  ID type of insurance company (payor)
- Subscriber.Insurance.Company.Name
  String
  Probable
  Name of insurance company (payor)
- Subscriber.Insurance.Company.Address
  Object
  Probable
  Insurance company's address
- Subscriber.Insurance.Company.Address.StreetAddress
  String
  Probable
  Street address
- Subscriber.Insurance.Company.Address.City
  String
  Probable
  City
- Subscriber.Insurance.Company.Address.State
  String
  Probable
  State
- Subscriber.Insurance.Company.Address.ZIP
  String
  Probable
  ZIP
- Subscriber.Insurance.Company.Address.County
  String
  Possible
  County
- Subscriber.Insurance.Company.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Subscriber.Insurance.Company.PhoneNumber
  String
  Probable
  Insurance companys phone number.
  In E. 164 Format (i.e. +16085551234)
- Subscriber.Insurance.GroupNumber
  String
  Probable
  Insurance policy group number
- Subscriber.Insurance.GroupName
  String
  Probable
  Insurance policy group name
- Subscriber.Insurance.EffectiveDate
  String
  Probable
  Effect date of this insurance policy.
  In YYYY-MM-DD format
- Subscriber.Insurance.ExpirationDate
  String
  Probable
  Expiration date of this insurance policy.
  In YYYY-MM-DD format
- Subscriber.Insurance.PolicyNumber
  String
  Probable
  Insurance policy number
- Subscriber.Insurance.Priority
  String
  Possible
  ValueSet
  The insurance priority sequence.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Subscriber.Insurance.AgreementType
  String
  Probable
  ValueSet
  Type of insurance agreement.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Subscriber.Insurance.CoverageType
  String
  Probable
  ValueSet
  Type of insurance agreement.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
Patient
- Patient.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID types that identify the patient
- Patient.Identifiers[].ID
  String
  Reliable
  ID for the patient
- Patient.Identifiers[].IDType
  String
  Reliable
  Type of ID.
  E.g. MRN, EPI
- Patient.Demographics.FirstName
  String
  Reliable
  Patient's first name
- Patient.Demographics.MiddleName
  String
  Possible
  Patient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
- Patient.Demographics.LastName
  String
  Reliable
  Patient's last name
- Patient.Demographics.DOB
  String
  Reliable
  Patient's date of birth.
  In ISO 8601 format
- Patient.Demographics.SSN
  String
  Probable
  Patient's social security number
- Patient.Demographics.Sex
  String
  Reliable
  ValueSet
  Patient's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.Race
  String
  Possible
  ValueSet
  Patient's race
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.IsHispanic
  Boolean
  Possible
  ValueSet
  Indicates if the patient is of hispanic origin.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.Religion
  String
  Possible
  ValueSet
  Patient's religious affiliation
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.MaritalStatus
  String
  Possible
  ValueSet
  Patient's marital status
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.IsDeceased
  Boolean
  Possible
  Indicates if the patient is deceased
- Patient.Demographics.DeathDateTime
  DateTime
  Possible
  Date and Time the patient was proclaimed deceased.
  ISO 8601 Format
- Patient.Demographics.PhoneNumber.Home
  String
  Probable
  Patient's home phone number.
  In E. 164 Format. (e.g. +16085551234)
- Patient.Demographics.PhoneNumber.Office
  String
  Probable
  Patient's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Patient.Demographics.PhoneNumber.Mobile
  String
  Probable
  Patient's mobile phone number.
  In E. 164 Format. (e.g. +16085551234)
- Patient.Demographics.EmailAddresses[]
  Array of Strings
  Probable
  Patient's email address(es)
- Patient.Demographics.Language
  String
  Possible
  ValueSet
  Patient's primary spoken language
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.Citizenship[]
  Array of strings
  Possible
  ValueSet
  Patient's nation(s) of citizenship
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Demographics.Address
  Object
  Probable
  Patient's home address
- Patient.Demographics.Address.StreetAddress
  String
  Probable
  Street address
- Patient.Demographics.Address.City
  String
  Probable
  City
- Patient.Demographics.Address.State
  String
  Probable
  State
- Patient.Demographics.Address.ZIP
  String
  Probable
  ZIP
- Patient.Demographics.Address.County
  String
  Possible
  County
- Patient.Demographics.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Patient.Notes[]
  Array of strings
  Possible
  Patient-level notes
- Patient.Weight
  String
  Probable
  One of the following: "Patient", "Clinic", "Insurance", "Other". Indicates who will be receiving the bill for the service.
- Patient.IsPregnant
  String
  Probable
  One of the following: "Yes", "No", "Not Specified"
Claims
- Claims[]
  Array of Object
  Probable
  Array of claims on this transaction.
- Claims[].ID
  String
  Probable
  Identifier for this particular claim.
- Claims[].Type
  String
  Probable
  Type of Claim (Institutional only).
  E.x. 'Admit thru Discharge Claim', 'Replacement of Prior Claim ', Void/Cancel of Prior Claim '. May be referred to as the Bill Type Frequency
- Claims[].TotalAmount
  String
  Probable
  Total amount of all lines on the claim.
- Claims[].CopayAmount
  String
  Probable
  Amount the patient has paid or still owes.
- Claims[].IsProviderSignatureOnFile
  Boolean
  Probable
  Whether or not the provider signature is on file for the claim.
- Claims[].IsReleaseOfInformationOnFile
  Boolean
  Probable
  Whether or not the submitter has a signed ROI form for the patient.
- Claims[].ReferenceNumbers[].ID
  String
  Probable
  May include Prior Auth numbers, CLIA numbers, etc
- Claims[].ReferenceNumbers[].Type
  String
  Probable
- Claims[].Visit.VisitNumber
  String
  Reliable
  Visit Number.
  Unique ID of a single visit
- Claims[].Visit.DateTime
  String
  Probable
  DateTime of admission.
  ISO 8601 Format
- Claims[].Visit.DischargeDateTime
  String
  Probable
  DateTime of discharge.
  ISO 8601 Format
- Claims[].Visit.Type
  String
  Probable
  Type of inpatient admission.
  Only populated for inpatient admissions. E.x. Elective, Emergency
- Claims[].Visit.Location
  Object
  Probable
- Claims[].Visit.Location.Type
  String
  Probable
  Type of location.
  Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
- Claims[].Visit.Location.Facility
  String
  Probable
  Facility.
  Example: Community Hospital
- Claims[].Visit.Location.Department
  String
  Probable
  Department
- Claims[].Visit.Location.Room
  String
  Probable
  Room.
  Example: 136
- Claims[].Visit.PreviousLocation
  Object
  Probable
- Claims[].Visit.PreviousLocation.Type
  String
  Probable
  Type of location.
  Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
- Claims[].Visit.PreviousLocation.Facility
  String
  Probable
  Facility.
  Example: Community Hospital
- Claims[].Visit.PreviousLocation.Department
  String
  Probable
  Department
- Claims[].Visit.PreviousLocation.Room
  String
  Probable
  Room.
  Example: 136
- Claims[].AdditionalDates[].Type
  String
  Probable
  Type of date value.
  e.x. Service Period Start (https://ushik.ahrq.gov/ViewItemDetails?system=sdo&itemKey=133121000)
- Claims[].AdditionalDates[].DateTime
  String
  Probable
  ISO 8601 Format
- Claims[].Diagnoses[].Code
  String
  Probable
  Diagnosis code.
  First index in array indicates primary diagnosis
- Claims[].Diagnoses[].Codeset
  String
  Probable
  Code set used to identify the diagnosis code.
  e.x. ICD-10, ICD-9
- Claims[].Diagnoses[].Name
  String
  Probable
  Diagnosis name
- Claims[].Diagnoses[].Type
  String
  Probable
  Type of diagnosis.
  One of the following: Admitting, Working, or Final
- Claims[].DiagnosisRelatedGroup
  String
  Probable
  CMS Diagnosis Related Group for an inpatient admission
- Claims[].Procedures[].Code
  String
  Probable
  Procedure codes associated with this claim
- Claims[].Procedures[].CodeSet
  String
  Probable
  Code set used to identify the procedure code.
  e.x. CPT, HCPCS, SNOMED, or LOINC
- Claims[].Procedures[].Name
  String
  Probable
  Name of procedure
- Claims[].Procedures[].Modifiers[]
  String
  Probable
  Array of procedure modifiers
- Claims[].Lines[]
  String
  Probable
- Claims[].Lines[].ID
  String
  Probable
  Identifier for the line item.
- Claims[].Lines[].Amount
  String
  Probable
  Total dollar amount for this line item.
- Claims[].Lines[].Diagnoses[].Code
  String
  Probable
  Diagnosis code.
  First index in array indicates primary diagnosis associated with this service line item.
- Claims[].Lines[].Diagnoses[].Codeset
  String
  Probable
  Code set used to identify the diagnosis code.
  e.x. ICD-10, ICD-9
- Claims[].Lines[].Diagnoses[].Name
  String
  Probable
  Diagnosis name
- Claims[].Lines[].Diagnoses[].Type
  String
  Probable
  Type of diagnosis.
  One of the following: Admitting, Working, or Final
- Claims[].Lines[].Procedure.Code
  String
  Probable
  Procedure codes associated with this service line item.
- Claims[].Lines[].Procedure.CodeSet
  String
  Probable
  Code set used to identify the procedure code.
  e.x. CPT, HCPCS, SNOMED, or LOINC
- Claims[].Lines[].Procedure.Name
  String
  Probable
  Name of procedure
- Claims[].Lines[].Procedure.Modifiers[]
  String
  Probable
  Array of procedure modifiers
- Claims[].Lines[].ServiceDateTime
  String
  Probable
  When the procedure conveyed in this line item began.
- Claims[].Lines[].ServiceEndDateTime
  String
  Probable
  When the procedure conveyed in this line item ended.
- Claims[].Lines[].RevenueCode
  String
  Probable
  Institutional only.
- Claims[].Lines[].UnitCount
  String
  Probable
  Numeric value for units of service rendered.
- Claims[].Lines[].Units
  String
  Probable
  Units corresponding to UnitCount, (days, units, etc.)
- Claims[].Lines[].IsEmergency
  Boolean
  Probable
  Whether or not this service was performed in an emergency setting.
- Claims[].Lines[].Notes
  String
  Probable
  Additional notes for this line
- Claims[].Providers[].ID
  String
  Probable
  ID of billing provider
- Claims[].Providers[].IDType
  String
  Probable
  Type of ID.
  Commonly 'NPI'
- Claims[].Providers[].Role
  String
  Probable
  The role this provider has in patient care.
  E.x. Attending, Referring, Operating
- Claims[].Providers[].FirstName
  String
  Probable
- Claims[].Providers[].MiddleName
  String
  Probable
- Claims[].Providers[].LastName
  String
  Probable
- Claims[].Providers[].Specialty.ID
  String
  Probable
  ID of specialty.
  Commonly the taxonomy ID
- Claims[].Providers[].Specialty.Description
  String
  Probable
  Description/name of specialty

Sample MessageDownload JSON Schema

{
   "Meta": {
      "DataModel": "Claim",
      "EventType": "Submission",
      "EventDateTime": "2022-06-30T16:07:58.135Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Logs": [
         {
            "ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
            "AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Transaction": {
      "ID": "94151100100",
      "IDType": null,
      "Type": "Professional",
      "Submitter": {
         "ID": null,
         "IDType": null,
         "Name": null,
         "EmailAddress": null,
         "PhoneNumber": {
            "Office": null,
            "Fax": null
         }
      },
      "Receiver": {
         "ID": null,
         "IDType": null,
         "Name": null
      }
   },
   "BillingProvider": {
      "ID": "4356789876",
      "IDType": "NPI",
      "TIN": null,
      "FirstName": "Pat",
      "MiddleName": null,
      "LastName": "Granite",
      "OrganizationName": null,
      "Specialty": {
         "ID": null,
         "Description": null
      },
      "Address": {
         "StreetAddress": "123 Main St.",
         "City": "Madison",
         "State": "WI",
         "ZIP": "53703",
         "County": "Dane",
         "Country": "USA"
      },
      "EmailAddress": null,
      "PhoneNumber": {
         "Office": "+16085551234",
         "Fax": null
      }
   },
   "Subscriber": {
      "ID": null,
      "IDType": null,
      "FirstName": "Timothy",
      "MiddleName": "Paul",
      "LastName": "Bixby",
      "OrganizationName": null,
      "Address": {
         "StreetAddress": "4762 Hickory Street",
         "City": "Monroe",
         "State": "WI",
         "ZIP": "53566",
         "County": "Green",
         "Country": "US"
      },
      "DOB": "2008-01-06",
      "Sex": "Male",
      "RelationToPatient": "Self",
      "ResponsibilityLevel": "Primary",
      "Insurance": {
         "Plan": {
            "ID": "31572",
            "IDType": "Payor ID",
            "Name": "HMO Deductible Plan",
            "Type": null
         },
         "MemberNumber": null,
         "Company": {
            "ID": "60054",
            "IDType": null,
            "Name": "aetna (60054 0131)",
            "Address": {
               "StreetAddress": "PO Box 14080",
               "City": "Lexington",
               "State": "KY",
               "ZIP": "40512-4079",
               "County": "Fayette",
               "Country": "US"
            },
            "PhoneNumber": "+18089541123"
         },
         "GroupNumber": "847025-024-0009",
         "GroupName": "Accelerator Labs",
         "EffectiveDate": "2015-01-01",
         "ExpirationDate": "2020-12-31",
         "PolicyNumber": "9140860055",
         "Priority": null,
         "AgreementType": null,
         "CoverageType": null
      }
   },
   "Patient": {
      "Identifiers": [
         {
            "ID": "0000000001",
            "IDType": "MR"
         },
         {
            "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
            "IDType": "EHRID"
         },
         {
            "ID": "a1d4ee8aba494ca",
            "IDType": "NIST"
         }
      ],
      "Demographics": {
         "FirstName": "Timothy",
         "MiddleName": "Paul",
         "LastName": "Bixby",
         "DOB": "2008-01-06",
         "SSN": "101-01-0001",
         "Sex": "Male",
         "Race": "White",
         "IsHispanic": null,
         "Religion": null,
         "MaritalStatus": "Single",
         "IsDeceased": null,
         "DeathDateTime": null,
         "PhoneNumber": {
            "Home": "+18088675301",
            "Office": null,
            "Mobile": null
         },
         "EmailAddresses": [],
         "Language": "en",
         "Citizenship": [],
         "Address": {
            "StreetAddress": "4762 Hickory Street",
            "City": "Monroe",
            "State": "WI",
            "ZIP": "53566",
            "County": "Green",
            "Country": "US"
         }
      },
      "Notes": [],
      "Weight": null,
      "IsPregnant": null
   },
   "Claims": [
      {
         "ID": "123456789",
         "Type": "Admit thru Discharge Claim",
         "TotalAmount": "200.00",
         "CopayAmount": "10.00",
         "IsProviderSignatureOnFile": true,
         "IsReleaseOfInformationOnFile": true,
         "ReferenceNumbers": [
            {
               "ID": "AUTH000000",
               "Type": null
            }
         ],
         "Visit": {
            "VisitNumber": null,
            "DateTime": "2016-10-08",
            "DischargeDateTime": null,
            "Type": null,
            "Location": {
               "Type": "Outpatient Clinic",
               "Facility": "RHS Vista Oaks Clinic",
               "Department": "Vista Oaks Clinic",
               "Room": null
            },
            "PreviousLocation": {
               "Type": null,
               "Facility": null,
               "Department": null,
               "Room": null
            }
         },
         "AdditionalDates": [
            {
               "Type": "Service Period Start",
               "DateTime": "2016-10-08"
            }
         ],
         "Diagnoses": [
            {
               "Code": "M54.5",
               "Codeset": "ICD-10",
               "Name": "Lower back pain",
               "Type": null
            },
            {
               "Code": "J45.909",
               "Codeset": "ICD-10",
               "Name": "Unspecified asthma, uncomplicated",
               "Type": null
            }
         ],
         "DiagnosisRelatedGroup": null,
         "Procedures": [],
         "Lines": [
            {
               "ID": "12345678",
               "Amount": "100.00",
               "Diagnoses": [],
               "Procedure": {
                  "Code": "73560",
                  "CodeSet": "CPT",
                  "Name": null,
                  "Modifiers": []
               },
               "ServiceDateTime": "2016-10-5",
               "ServiceEndDateTime": null,
               "RevenueCode": null,
               "UnitCount": "1",
               "Units": "Units",
               "IsEmergency": false,
               "Notes": null
            }
         ],
         "Providers": [
            {
               "ID": "4236464757",
               "IDType": "NPI",
               "Role": "Attending",
               "FirstName": "John",
               "MiddleName": null,
               "LastName": "Slate",
               "Specialty": {
                  "ID": "1223G0001X",
                  "Description": "General Practice"
               }
            }
         ]
      }
   ]
}

Payment

BETA

A Payment message is used to send a payment notification, typically from a payer to a healthcare provider, but it may be used in other situations where funds are transferred from one party to another. This is commonly sent as an EDI 835.

Fields

Show Required Fields Only

Show Translation Fields

Meta
- Meta.DataModel
  String
  Reliable
  Required
  Claim
- Meta.EventType
  String
  Reliable
  Required
  Payment
- Meta.EventDateTime
  DateTime
  Reliable
  DateTime of the event.
  ISO 8601 Format
- Meta.Test
  Boolean
  Reliable
  Flag as a test message
- Meta.Source
  String
  Reliable
  Where the message originated.
  Included in messages from Redox
- Meta.Source.ID
  String
  Reliable
  ID of the source.
  UUID
- Meta.Source.Name
  String
  Reliable
  Name of the source
- Meta.Destinations[]
  Array of Objects
  Reliable
  List of destinations to send your message to. All messages must have at least one destination. Queries accept only one destination.
  Required when sending data to Redox
- Meta.Destinations[].ID
  String
  Reliable
  ID of the destination.
  UUID
- Meta.Destinations[].Name
  String
  Reliable
  Name of the destination
- Meta.Logs[]
  Array of Objects
  Reliable
  Request log identifiers.
- Meta.Logs[].ID
  String
  Reliable
  ID of a request log that corresponds to this request, used for support and reference within the Redox dashboard.
  UUID
- Meta.Logs[].AttemptID
  String
  Reliable
  ID of request log attempt. Useful in cases where retries are possible.
  UUID
- Meta.Message
  String
  Reliable
  Record in Redox that corresponds to the communication sent from the source to Redox.
  Included in messages from Redox
- Meta.Message.ID
  Numeric
  Reliable
  ID of the message created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.Transmission
  String
  Reliable
  Record in Redox that corresponds to the communication sent from Redox to your destination.
  Included in messages from Redox
- Meta.Transmission.ID
  Numeric
  Reliable
  ID of the transmission created in Redox.
  (Deprecated. Slated for removal on or after Nov. 1, 2022. Use Meta.Logs[].ID instead)
- Meta.FacilityCode
  String
  Possible
  Code for the facility related to the message.
  Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Transaction
- Transaction.ID
  String
  Reliable
  ID used by Sender to reference this claim
- Transaction.IDType
  String
  Reliable
  Type of ID
- Transaction.Type
  String
  Reliable
  The type of claim, Institutional or Professional.
- Transaction.Submitter.ID
  String
  Reliable
  ID of the submitter
- Transaction.Submitter.IDType
  String
  Reliable
  Type of ID
- Transaction.Submitter.Name
  String
  Reliable
  Name of submitter
- Transaction.Submitter.EmailAddress
  String
  Reliable
  Email address
- Transaction.Submitter.PhoneNumber.Office
  String
  Reliable
  Submitter's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Transaction.Submitter.PhoneNumber.Fax
  String
  Reliable
  Submitter's fax number.
  In E. 164 Format. (e.g. +16085551234)
- Transaction.Receiver.ID
  String
  Reliable
  ID of transaction recipient
- Transaction.Receiver.IDType
  String
  Reliable
  Type of ID
- Transaction.Receiver.Name
  String
  Reliable
  Name of transaction recipient
- Transaction.TotalPaymentAmount
  String
  Probable
  The total amount of all of the payments listed in the Payments array.
  Redox can calculate this for you, but we recommend sending it as an additional layer of validation.
- Transaction.CreditOrDebit
  String
  Probable
  A flag indicating whether the monetary amount in Transaction.TotalPaymentAmount is a credit or debit.
  Send either "Credit" or "Debit" in this field.
- Transaction.PaymentMethod
  String
  Probable
  How the payment was/will be transferred.
  We currently support "Check" and "ACH".
- Transaction.PaymentDateTime
  DateTime
  Probable
  When the transaction should be processed by the destination.
  For example, if the "Check" is used in Transaction.PaymentMethod this would be the date on the check.
- Transaction.TrackingNumber
  String
  Probable
  A number used to by the Payer to trace the payment.
  For example, if the "Check" is used in Transaction.PaymentMethod this would be the check number.
Payer
- Payer
  String
  Probable
- Payer.ID
  String
  Probable
- Payer.IDType
  String
  Probable
- Payer.Name
  String
  Probable
- Payer.Address
  String
  Probable
- Payer.Address.StreetAddress
  String
  Probable
  Street address
- Payer.Address.City
  String
  Probable
  City
- Payer.Address.State
  String
  Probable
  State
- Payer.Address.ZIP
  String
  Probable
  ZIP
- Payer.Address.County
  String
  Probable
  County
- Payer.Address.Country
  String
  Probable
  Country
- Payer.EmailAddress
  String
  Probable
  Email address
- Payer.PhoneNumber.Office
  String
  Probable
  Submitter's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Payer.PhoneNumber.Fax
  String
  Probable
  Submitter's fax number.
  In E. 164 Format. (e.g. +16085551234)
Payee
- Payee
  String
  Probable
- Payee.ID
  String
  Probable
- Payee.IDType
  String
  Probable
- Payee.Name
  String
  Probable
- Payee.Address
  String
  Probable
- Payee.Address.StreetAddress
  String
  Probable
  Street address
- Payee.Address.City
  String
  Probable
  City
- Payee.Address.State
  String
  Probable
  State
- Payee.Address.ZIP
  String
  Probable
  ZIP
- Payee.Address.County
  String
  Probable
  County
- Payee.Address.Country
  String
  Probable
  Country
- Payee.EmailAddress
  String
  Probable
  Email address
- Payee.PhoneNumber.Office
  String
  Probable
  Submitter's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Payee.PhoneNumber.Fax
  String
  Probable
  Submitter's fax number.
  In E. 164 Format. (e.g. +16085551234)
Payments
- Payments[]
  String
  Probable
- Payments[].DateTime
  DateTime
  Probable
  The DateTime this payment was processed
- Payments[].Patient.Identifiers[]
  Array of Objects
  Reliable
  List of IDs and ID types that identify the patient
- Payments[].Patient.Identifiers[].ID
  String
  Reliable
  Required
  ID for the patient
- Payments[].Patient.Identifiers[].IDType
  String
  Reliable
  Required
  Type of ID.
  E.g. MRN, EPI
- Payments[].Patient.Demographics.FirstName
  String
  Reliable
  Patient's first name
- Payments[].Patient.Demographics.MiddleName
  String
  Possible
  Patient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
- Payments[].Patient.Demographics.LastName
  String
  Reliable
  Patient's last name
- Payments[].Patient.Demographics.DOB
  String
  Reliable
  Patient's date of birth.
  In ISO 8601 format
- Payments[].Patient.Demographics.SSN
  String
  Probable
  Patient's social security number
- Payments[].Patient.Demographics.Sex
  String
  Reliable
  ValueSet
  Patient's sex
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.Race
  String
  Possible
  ValueSet
  Patient's race
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.IsHispanic
  Boolean
  Possible
  ValueSet
  Indicates if the patient is of hispanic origin.
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.Religion
  String
  Possible
  ValueSet
  Patient's religious affiliation
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.MaritalStatus
  String
  Possible
  ValueSet
  Patient's marital status
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.IsDeceased
  Boolean
  Possible
  Indicates if the patient is deceased
- Payments[].Patient.Demographics.DeathDateTime
  DateTime
  Possible
  Date and Time the patient was proclaimed deceased.
  ISO 8601 Format
- Payments[].Patient.Demographics.PhoneNumber.Home
  String
  Probable
  Patient's home phone number.
  In E. 164 Format. (e.g. +16085551234)
- Payments[].Patient.Demographics.PhoneNumber.Office
  String
  Probable
  Patient's office phone number.
  In E. 164 Format. (e.g. +16085551234)
- Payments[].Patient.Demographics.PhoneNumber.Mobile
  String
  Probable
  Patient's mobile phone number.
  In E. 164 Format. (e.g. +16085551234)
- Payments[].Patient.Demographics.EmailAddresses[]
  Array of Strings
  Probable
  Patient's email address(es)
- Payments[].Patient.Demographics.Language
  String
  Possible
  ValueSet
  Patient's primary spoken language
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.Citizenship[]
  Array of strings
  Possible
  ValueSet
  Patient's nation(s) of citizenship
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Demographics.Address
  Object
  Probable
  Patient's home address
- Payments[].Patient.Demographics.Address.StreetAddress
  String
  Probable
  Street address
- Payments[].Patient.Demographics.Address.City
  String
  Probable
  City
- Payments[].Patient.Demographics.Address.State
  String
  Probable
  State
- Payments[].Patient.Demographics.Address.ZIP
  String
  Probable
  ZIP
- Payments[].Patient.Demographics.Address.County
  String
  Possible
  County
- Payments[].Patient.Demographics.Address.Country
  String
  Possible
  ValueSet
  Country
  
  Supported Values
  
  Additional values may be added by Redox in the future.
- Payments[].Patient.Notes[]
  Array of strings
  Possible
  Patient-level notes
- Payments[].Claim.Number
  String
  Probable
  The Payer's reference number
- Payments[].Claim.SubmissionNumber
  String
  Probable
  This will generally be the claim number sent on the Submission (837).
- Payments[].Claim.ReceivedDate
  String
  Probable
  Date the claim was submitted
- Payments[].Claim.ServiceDateTime
  DateTime
  Probable
  Date the statement period started
- Payments[].Claim.ServiceEndDateTime
  DateTime
  Probable
  Date the statement period ended
- Payments[].Claim.Status
  String
  Probable
  Status of the claim
- Payments[].Claim.ChargedAmount
  String
  Probable
  Total monetary amount of the claim
- Payments[].Claim.PaymentAmount
  String
  Probable
  Monetary amount of the claim paid
- Payments[].Claim.PatientResponsibilityAmount
  String
  Probable
  Monetary amount of the claim the patient is responsible for
- Payments[].Claim.Adjustments[]
  String
  Probable
  Adjustments explain why a claim was paid differently than it was billed.
- Payments[].Claim.Adjustments[].Amount
  String
  Probable
  Monetary amount of the adjustment.
  A negative number indicates a payment increase, while a positive number indicates a payment reduction.
- Payments[].Claim.Adjustments[].ReasonGroup
  String
  Probable
  Adjustment group.
  E.x. Contractual Obligation, Other Adjustments, Payer Initiated Reductions, Patient Responsibility
- Payments[].Claim.Adjustments[].Quantity
  String
  Probable
- Payments[].Claim.Adjustments[].Reason
  String
  Probable
  Adjustment reason
- Payments[].Claim.ReferenceNumbers[].ID
  String
  Probable
  May include Prior Auth numbers, CLIA numbers, etc
- Payments[].Claim.ReferenceNumbers[].IDType
  String
  Probable
- Payments[].Claim.Services[]
  String
  Probable
  This array will provide additional detail for claims processed at the line level.
- Payments[].Claim.Services[].ChargedAmount
  String
  Probable
  The monetory amount charged
- Payments[].Claim.Services[].PaymentAmount
  String
  Probable
  The monetory amount paid
- Payments[].Claim.Services[].ChargedUnits
  String
  Probable
  The number of units of service charged for
- Payments[].Claim.Services[].PaymentUnits
  String
  Probable
  The number of units of service paid for
- Payments[].Claim.Services[].AllowedAmount
  String
  Probable
  Maximum monetary amount of payment
- Payments[].Claim.Services[].DeductibleAmount
  String
  Probable
  Monetary amount of patient deductible
- Payments[].Claim.Services[].SubmittedProcedure.Code
  String
  Probable
  Procedure codes associated with this service.
- Payments[].Claim.Services[].SubmittedProcedure.CodeSet
  String
  Probable
  Code set used to identify the procedure code
- Payments[].Claim.Services[].SubmittedProcedure.Name
  String
  Probable
  Name of procedure
- Payments[].Claim.Services[].SubmittedProcedure.Modifiers[]
  String
  Probable
  Array of procedure modifiers
- Payments[].Claim.Services[].AdjudicatedProcedure.Code
  String
  Probable
  Adjudicated procedure codes associated with this service.
- Payments[].Claim.Services[].AdjudicatedProcedure.CodeSet
  String
  Probable
  Code set used to identify the procedure code
- Payments[].Claim.Services[].AdjudicatedProcedure.Name
  String
  Probable
  Name of procedure
- Payments[].Claim.Services[].AdjudicatedProcedure.Modifiers[]
  String
  Probable
  Array of procedure modifiers
- Payments[].Claim.Services[].ServiceDateTime
  DateTime
  Probable
  Date the claim was submitted
- Payments[].Claim.Services[].ServiceEndDateTime
  DateTime
  Probable
  Date the statement period started
- Payments[].Claim.Services[].ReferenceNumbers[].ID
  String
  Probable
  May include Prior Auth numbers, CLIA numbers, etc
- Payments[].Claim.Services[].ReferenceNumbers[].IDType
  String
  Probable

Sample MessageDownload JSON Schema

{
   "Meta": {
      "DataModel": "Claim",
      "EventType": "Payment",
      "EventDateTime": "2022-06-30T16:07:58.135Z",
      "Test": true,
      "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
      },
      "Destinations": [
         {
            "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
            "Name": "Redox EMR"
         }
      ],
      "Logs": [
         {
            "ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
            "AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
         }
      ],
      "Message": {
         "ID": 5565
      },
      "Transmission": {
         "ID": 12414
      },
      "FacilityCode": null
   },
   "Transaction": {
      "ID": "000000001",
      "IDType": null,
      "Type": null,
      "Submitter": {
         "ID": null,
         "IDType": null,
         "Name": "National Insurance Company of Redox",
         "EmailAddress": null,
         "PhoneNumber": {
            "Office": null,
            "Fax": null
         }
      },
      "Receiver": {
         "ID": null,
         "IDType": null,
         "Name": "Redox Health System"
      },
      "TotalPaymentAmount": "580.00",
      "CreditOrDebit": "Credit",
      "PaymentMethod": "Check",
      "PaymentDateTime": "2016-11-11T02:11:03.111Z",
      "TrackingNumber": "8675309"
   },
   "Payer": {
      "ID": "999999999",
      "IDType": "HPID",
      "Name": "Cherdabee Insurance Corp",
      "Address": {
         "StreetAddress": "123 fake street",
         "City": "Los Angeles",
         "State": "CA",
         "ZIP": "90210",
         "County": null,
         "Country": null
      },
      "EmailAddress": null,
      "PhoneNumber": {
         "Office": null,
         "Fax": null
      }
   },
   "Payee": {
      "ID": "51531312",
      "IDType": null,
      "Name": "Redox Health System",
      "Address": {
         "StreetAddress": "2020 Eastwood Drive",
         "City": "Madison",
         "State": "WI",
         "ZIP": "53704",
         "County": null,
         "Country": null
      },
      "EmailAddress": null,
      "PhoneNumber": {
         "Office": null,
         "Fax": null
      }
   },
   "Payments": [
      {
         "DateTime": "2016-11-08T02:11:03.111Z",
         "Patient": {
            "Identifiers": [
               {
                  "ID": "0000000001",
                  "IDType": "MR"
               },
               {
                  "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                  "IDType": "EHRID"
               },
               {
                  "ID": "a1d4ee8aba494ca",
                  "IDType": "NIST"
               }
            ],
            "Demographics": {
               "FirstName": "Timothy",
               "MiddleName": "Paul",
               "LastName": "Bixby",
               "DOB": "2008-01-06",
               "SSN": "101-01-0001",
               "Sex": "Male",
               "Race": "White",
               "IsHispanic": null,
               "Religion": null,
               "MaritalStatus": "Single",
               "IsDeceased": null,
               "DeathDateTime": null,
               "PhoneNumber": {
                  "Home": "+18088675301",
                  "Office": null,
                  "Mobile": null
               },
               "EmailAddresses": [],
               "Language": "en",
               "Citizenship": [],
               "Address": {
                  "StreetAddress": "4762 Hickory Street",
                  "City": "Monroe",
                  "State": "WI",
                  "ZIP": "53566",
                  "County": "Green",
                  "Country": "US"
               }
            },
            "Notes": []
         },
         "Claim": {
            "Number": "94151100100",
            "SubmissionNumber": null,
            "ReceivedDate": "2016-10-31",
            "ServiceDateTime": "2016-10-08T08:58:03.125Z",
            "ServiceEndDateTime": "2016-10-11T14:58:03.532Z",
            "Status": "Processed as Primary",
            "ChargedAmount": "100.00",
            "PaymentAmount": "65.00",
            "PatientResponsibilityAmount": "20.00",
            "Adjustments": [],
            "ReferenceNumbers": [
               {
                  "ID": "AUTH000000",
                  "IDType": "Prior Authorization"
               }
            ],
            "Services": [
               {
                  "ChargedAmount": "100.00",
                  "PaymentAmount": "65.00",
                  "ChargedUnits": null,
                  "PaymentUnits": null,
                  "AllowedAmount": "85.00",
                  "DeductibleAmount": null,
                  "SubmittedProcedure": {
                     "Code": "55454-3",
                     "CodeSet": "LOINC",
                     "Name": null,
                     "Modifiers": []
                  },
                  "AdjudicatedProcedure": {
                     "Code": "55454-3",
                     "CodeSet": "LOINC",
                     "Name": null,
                     "Modifiers": []
                  },
                  "ServiceDateTime": "2016-10-08T08:58:03.624Z",
                  "ServiceEndDateTime": "2016-10-08T14:58:03.263Z",
                  "ReferenceNumbers": []
               }
            ]
         }
      },
      {
         "DateTime": "2016-11-08T02:11:03.111Z",
         "Patient": {
            "Identifiers": [
               {
                  "ID": "0000000001",
                  "IDType": "MR"
               },
               {
                  "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
                  "IDType": "EHRID"
               },
               {
                  "ID": "a1d4ee8aba494ca",
                  "IDType": "NIST"
               }
            ],
            "Demographics": {
               "FirstName": "Timothy",
               "MiddleName": "Paul",
               "LastName": "Bixby",
               "DOB": "2008-01-06",
               "SSN": "101-01-0001",
               "Sex": "Male",
               "Race": "White",
               "IsHispanic": null,
               "Religion": null,
               "MaritalStatus": "Single",
               "IsDeceased": null,
               "DeathDateTime": null,
               "PhoneNumber": {
                  "Home": "+18088675301",
                  "Office": null,
                  "Mobile": null
               },
               "EmailAddresses": [],
               "Language": "en",
               "Citizenship": [],
               "Address": {
                  "StreetAddress": "4762 Hickory Street",
                  "City": "Monroe",
                  "State": "WI",
                  "ZIP": "53566",
                  "County": "Green",
                  "Country": "US"
               }
            },
            "Notes": []
         },
         "Claim": {
            "Number": "94151100100",
            "SubmissionNumber": null,
            "ReceivedDate": "2016-10-31",
            "ServiceDateTime": "2016-10-08T08:58:03.125Z",
            "ServiceEndDateTime": "2016-10-11T14:58:03.532Z",
            "Status": "Processed as Primary",
            "ChargedAmount": "100.00",
            "PaymentAmount": "75.00",
            "PatientResponsibilityAmount": "20.00",
            "Adjustments": [],
            "ReferenceNumbers": [
               {
                  "ID": "AUTH000000",
                  "IDType": "Prior Authorization"
               }
            ],
            "Services": [
               {
                  "ChargedAmount": "100.00",
                  "PaymentAmount": "75.00",
                  "ChargedUnits": null,
                  "PaymentUnits": null,
                  "AllowedAmount": "95.00",
                  "DeductibleAmount": null,
                  "SubmittedProcedure": {
                     "Code": "99211",
                     "CodeSet": "LOINC",
                     "Name": null,
                     "Modifiers": []
                  },
                  "AdjudicatedProcedure": {
                     "Code": "99211",
                     "CodeSet": "LOINC",
                     "Name": null,
                     "Modifiers": []
                  },
                  "ServiceDateTime": "2016-10-08T08:58:03.624Z",
                  "ServiceEndDateTime": "2016-10-08T14:58:03.263Z",
                  "ReferenceNumbers": [
                     {
                        "ID": "1",
                        "IDType": "Control Number"
                     }
                  ]
               }
            ]
         }
      }
   ]
}

Claim

SubmissionBatchlink

Fields

Meta

Transactions

PaymentBatchlink

Fields

Meta

Transactions

Submissionlink

Fields

Meta

Transaction

BillingProvider

Subscriber

Patient

Claims

Paymentlink

Fields

Meta

Transaction

Payer

Payee

Payments

SubmissionBatch

PaymentBatch

Submission

Payment