Tross
UNITEDHEALTHCARE

Fetch Claims

Fetch claims in UHC

POSThttps://api.ontross.com/api/integrations/uhc/fetch-claims
Request Fields
input
object
required
Input object.
input.date_of_service
string
required
Date of service
input.payer_id
string
required
Payer id
input.subscriber_id
string
required
Subscriber id
input.date_of_birth
string
required
Date of birth
input.provider_id
string
required
Provider id
input.tax_id_number
string
required
Tax id number
auth_id
string
required
Auth id
Output Fields
claim_responses
array
List of claim responses.
claim_responses[].claim_id
string
Claim id
claim_responses[].claim_number
string
Claim number
claim_responses[].claim_type
string
Claim type
claim_responses[].date_of_service
object
Date of service object.
claim_responses[].date_of_service.year
integer
Year
claim_responses[].date_of_service.month
integer
Month
claim_responses[].date_of_service.day
integer
Day
claim_responses[].patient
object
Patient object.
claim_responses[].patient.name
object
Name object.
claim_responses[].patient.name.first_name
string
First name
claim_responses[].patient.name.last_name
string
Last name
claim_responses[].patient.name.middle_initial
string
Middle initial
claim_responses[].patient.name.suffix
string
Suffix
claim_responses[].patient.dob
object
Date of service object.
claim_responses[].patient.dob.year
integer
Year
claim_responses[].patient.dob.month
integer
Month
claim_responses[].patient.dob.day
integer
Day
claim_responses[].patient.gender
string
Gender
claim_responses[].patient.phone_number
string
Phone number
claim_responses[].patient.other_phone_number
string
Other phone number
claim_responses[].patient.address
string
Address
claim_responses[].patient.email_id
string
Email id
claim_responses[].primary_insurance
object
Primary insurance object.
claim_responses[].primary_insurance.uuid
string
Uuid
claim_responses[].primary_insurance.subscriber_id
string
Subscriber id
claim_responses[].primary_insurance.subscriber
object
Subscriber object.
claim_responses[].primary_insurance.subscriber.name
object
Name object.
claim_responses[].primary_insurance.subscriber.name.first_name
string
First name
claim_responses[].primary_insurance.subscriber.name.last_name
string
Last name
claim_responses[].primary_insurance.subscriber.name.middle_initial
string
Middle initial
claim_responses[].primary_insurance.subscriber.name.suffix
string
Suffix
claim_responses[].primary_insurance.subscriber.dob
object
Date of service object.
claim_responses[].primary_insurance.subscriber.dob.year
integer
Year
claim_responses[].primary_insurance.subscriber.dob.month
integer
Month
claim_responses[].primary_insurance.subscriber.dob.day
integer
Day
claim_responses[].primary_insurance.subscriber.gender
string
Gender
claim_responses[].primary_insurance.subscriber.phone_number
string
Phone number
claim_responses[].primary_insurance.subscriber.other_phone_number
string
Other phone number
claim_responses[].primary_insurance.subscriber.address
string
Address
claim_responses[].primary_insurance.subscriber.email_id
string
Email id
claim_responses[].primary_insurance.subscriber.relationship_to_patient
string
Relationship to patient
claim_responses[].primary_insurance.subscriber.ehr_id
string
Ehr id
claim_responses[].primary_insurance.payor_name
string
Payor name
claim_responses[].primary_insurance.plan_name
string
Plan name
claim_responses[].primary_insurance.group_number
string
Group number
claim_responses[].primary_insurance.auth_number
string
Auth number
claim_responses[].primary_insurance.name_for_portal_check
string
Name for portal check
claim_responses[].primary_insurance.portal_checks
string
Portal checks
claim_responses[].primary_insurance.source
string
Source
claim_responses[].primary_insurance.payor_ehr_id
string
Payor ehr id
claim_responses[].primary_insurance.metadata
object
Metadata object.
claim_responses[].primary_insurance.attachments
array
List of attachments.
claim_responses[].secondary_insurance
object
Secondary insurance object.
claim_responses[].provider
object
Provider object.
claim_responses[].provider.name
string
Name
claim_responses[].provider.npi
string
Npi
claim_responses[].provider.tax_id
string
Tax id
claim_responses[].provider.type
string
Type
claim_responses[].line_items
array
List of line items.
claim_responses[].line_items[].date_of_service
object
Date of service object.
claim_responses[].line_items[].date_of_service.year
integer
Year
claim_responses[].line_items[].date_of_service.month
integer
Month
claim_responses[].line_items[].date_of_service.day
integer
Day
claim_responses[].line_items[].line_number
integer
Line number
claim_responses[].line_items[].procedure_code
string
Procedure code
claim_responses[].line_items[].modifiers
array
List of modifiers.
claim_responses[].line_items[].description
string
Description
claim_responses[].line_items[].diagnosis_codes
array
List of diagnosis codes.
claim_responses[].line_items[].diagnosis_descriptions
array
List of diagnosis descriptions.
claim_responses[].line_items[].units
integer
Units
claim_responses[].line_items[].status
object
Status object.
claim_responses[].line_items[].status.status
string
Status
claim_responses[].line_items[].status.code
string
Code
claim_responses[].line_items[].status.code_description
string
Code description
claim_responses[].line_items[].status.category_code
string
Category code
claim_responses[].line_items[].status.category_description
string
Category description
claim_responses[].line_items[].status.finalized_date
object
Date of service object.
claim_responses[].line_items[].status.finalized_date.year
integer
Year
claim_responses[].line_items[].status.finalized_date.month
integer
Month
claim_responses[].line_items[].status.finalized_date.day
integer
Day
claim_responses[].line_items[].status.comments
string
Comments
claim_responses[].line_items[].status.submission
object
Submission object.
claim_responses[].line_items[].status.remittance
object
Remittance object.
claim_responses[].line_items[].status.status_history
array
List of status history.
claim_responses[].line_items[].status.status_history[].status
string
Status
claim_responses[].line_items[].status.status_history[].date
string
Date
claim_responses[].line_items[].status.status_history[].description
string
Description
claim_responses[].line_items[].remarks
array
List of remarks.
claim_responses[].line_items[].remarks[].code
string
Code
claim_responses[].line_items[].remarks[].codeType
string
Code type
claim_responses[].line_items[].remarks[].description
string
Description
claim_responses[].line_items[].financial
object
Financial object.
claim_responses[].line_items[].financial.unit_charge
number
Unit charge
claim_responses[].line_items[].financial.billed_amount
number
Billed amount
claim_responses[].line_items[].financial.allowed_amount
number
Allowed amount
claim_responses[].line_items[].financial.paid
number
Paid
claim_responses[].line_items[].financial.copay
number
Copay
claim_responses[].line_items[].financial.deductible
number
Deductible
claim_responses[].line_items[].financial.coinsurance
number
Coinsurance
claim_responses[].line_items[].financial.balance
number
Balance
claim_responses[].line_items[].financial.patient_responsibility
number
Patient responsibility
claim_responses[].status
object
Status object.
claim_responses[].status.status
string
Status
claim_responses[].status.code
string
Code
claim_responses[].status.code_description
string
Code description
claim_responses[].status.category_code
string
Category code
claim_responses[].status.category_description
string
Category description
claim_responses[].status.finalized_date
object
Date of service object.
claim_responses[].status.finalized_date.year
integer
Year
claim_responses[].status.finalized_date.month
integer
Month
claim_responses[].status.finalized_date.day
integer
Day
claim_responses[].status.comments
string
Comments
claim_responses[].status.submission
object
Submission object.
claim_responses[].status.remittance
object
Remittance object.
claim_responses[].status.status_history
array
List of status history.
claim_responses[].status.status_history[].status
string
Status
claim_responses[].status.status_history[].date
string
Date
claim_responses[].status.status_history[].description
string
Description
claim_responses[].financial_summary
object
Financial object.
claim_responses[].financial_summary.unit_charge
number
Unit charge
claim_responses[].financial_summary.billed_amount
number
Billed amount
claim_responses[].financial_summary.allowed_amount
number
Allowed amount
claim_responses[].financial_summary.paid
number
Paid
claim_responses[].financial_summary.copay
number
Copay
claim_responses[].financial_summary.deductible
number
Deductible
claim_responses[].financial_summary.coinsurance
number
Coinsurance
claim_responses[].financial_summary.balance
number
Balance
claim_responses[].financial_summary.patient_responsibility
number
Patient responsibility
claim_responses[].raw_eob
object
Raw eob object.
claim_responses[].additional_properties
object
Additional properties object.
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/uhc/fetch-claims \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"date_of_service":"2026-01-01","payer_id":"string_id","subscriber_id":"string_id","date_of_birth":"2026-01-01","provider_id":"string_id","tax_id_number":"string_id"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "date_of_service": "2026-01-01",
    "payer_id": "string_id",
    "subscriber_id": "string_id",
    "date_of_birth": "2026-01-01",
    "provider_id": "string_id",
    "tax_id_number": "string_id"
  },
  "auth_id": "auth_uuid_here"
}