Tross
Demo dataBook a demo
ECLINICALWORKS

Fetch claims

List presubmission claims for a service date.

POSThttps://preview.ontross.com/api/integrations/ecw/fetch-claims
Request Fields
input.service_date
string
required
Single service date whose Presubmission claims to page through.
Example
"09/27/2025"
input.limit
integer
required
How many Presubmission claims to return after the offset.
Example
6
input.offset
integer
required
Zero-based index of the first claim to return.
Example
0
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
claim_details
array
Requested billing records with diagnosis and procedure entries.
claim_details[].claim
object
Insurance billing record containing identifiers and financial totals.
claim_details[].claim.ClaimId
string
Source identifier of the insurance billing record.
Example
"9000901"
claim_details[].claim.EncounterId
string
Clinical visit identifier associated with this billing record.
Example
"9000001"
claim_details[].claim.ProviderId
string
Clinician identifier associated with this billing record.
Example
"9001"
claim_details[].claim.PatientId
string
Chart identifier associated with this billing record.
Example
"900001"
claim_details[].claim.PatientName
string
Patient display label returned with this billing record.
Example
"Example,Jordan"
claim_details[].claim.ServiceDate
string
Calendar day the billed care was provided.
Example
"03/14/2026"
claim_details[].claim.ClaimDate
string
Calendar day recorded for the insurance billing record.
Example
"03/15/2026"
claim_details[].claim.amount
string
Total charge value returned for this billing record.
Example
"150.00"
claim_details[].claim.payment
string
Paid financial value returned for this billing record.
Example
"100.00"
claim_details[].claim.NetPayment
string
Net paid amount returned for this billing record.
Example
"100.00"
claim_details[].claim.balance
string
Remaining financial amount returned for this billing record.
Example
"50.00"
claim_details[].claim.ClaimStatus
string
Source disposition code for the insurance billing record.
Example
"1"
claim_details[].claim.ClaimStatusDesc
string
Readable disposition wording for the insurance billing record.
Example
"Presubmission"
claim_details[].claim.PayerName
string
Responsible insurer display label from the billing record.
Example
"Example Health Plan"
claim_details[].claim.ProviderCode
string
Clinician reference code returned with the billing record.
Example
"AEX"
claim_details[].icd_codes
array
Diagnosis billing entries attached to the insurance record.
claim_details[].icd_codes[].id
string
Source row identifier for this billed diagnosis entry.
Example
"9001001"
claim_details[].icd_codes[].ItemId
string
Catalog identifier associated with the billed diagnosis entry.
Example
"900401"
claim_details[].icd_codes[].code
string
Diagnosis classification value attached to the billing record.
Example
"I10"
claim_details[].icd_codes[].name
string
Readable diagnosis wording attached to the billing record.
Example
"Essential hypertension"
claim_details[].icd_codes[].primary
string
Raw indicator identifying the principal billed diagnosis.
Example
"1"
claim_details[].icd_codes[].notes
string
Recorded annotations attached to the billed diagnosis entry.
Example
"Confirmed during this visit."
claim_details[].icd_codes[].icdversion
string
Diagnosis classification revision used for this billing entry.
Example
"10"
claim_details[].cpt_codes
array
Procedure billing entries attached to the insurance record.
claim_details[].cpt_codes[].id
string
Source row identifier for this billed procedure entry.
Example
"9001101"
claim_details[].cpt_codes[].ItemId
string
Catalog identifier associated with the billed procedure entry.
Example
"900601"
claim_details[].cpt_codes[].code
string
Procedure billing classification attached to the claim.
Example
"99213"
claim_details[].cpt_codes[].name
string
Source display label for the billed procedure entry.
Example
"Office outpatient visit"
claim_details[].cpt_codes[].desc
string
Readable explanation of the billed procedure entry.
Example
"Established patient office visit"
claim_details[].cpt_codes[].primary
string
Raw indicator identifying the principal billed procedure.
Example
"1"
claim_details[].cpt_codes[].mod1
string
First billing modifier attached to the procedure entry.
Example
"25"
claim_details[].cpt_codes[].mod2
string
Second billing modifier attached to the procedure entry.
Example
"59"
claim_details[].cpt_codes[].mod3
string
Third billing modifier attached to the procedure entry.
Example
"RT"
claim_details[].cpt_codes[].mod4
string
Fourth billing modifier attached to the procedure entry.
Example
"76"
claim_details[].cpt_codes[].sdos
string
Beginning calendar day of the billed service interval.
Example
"03/14/2026"
claim_details[].cpt_codes[].edos
string
Ending calendar day of the billed service interval.
Example
"03/14/2026"
claim_details[].cpt_codes[].pos
string
Billing classification for the procedure's place of service.
Example
"11"
claim_details[].cpt_codes[].BilledUnitFee
string
Charged amount per unit of the billed procedure.
Example
"150.00"
claim_details[].cpt_codes[].units
string
Quantity of procedure services included in the charge.
Example
"1"
claim_details[].cpt_codes[].BilledFee
string
Total charged amount for the billed procedure entry.
Example
"150.00"
claim_details[].cpt_codes[].AllowedUnitFee
string
Permitted reimbursement amount per unit of the procedure.
Example
"110.00"
claim_details[].cpt_codes[].AllowedFee
string
Total permitted reimbursement amount for the procedure entry.
Example
"110.00"
claim_details[].cpt_codes[].ICD1
string
First diagnosis reference linked to the billed procedure.
Example
"1"
claim_details[].cpt_codes[].ICD2
string
Second diagnosis reference linked to the billed procedure.
Example
"2"
claim_details[].cpt_codes[].ICD3
string
Third diagnosis reference linked to the billed procedure.
Example
"3"
claim_details[].cpt_codes[].ICD4
string
Fourth diagnosis reference linked to the billed procedure.
Example
"4"
claim_details[].cpt_codes[].PtPortion
string
Patient responsibility amount associated with the procedure charge.
Example
"25.00"
claim_details[].cpt_codes[].BillToIns
string
Raw insurer billing value for the procedure entry.
Example
"1"
claim_details[].cpt_codes[].BillToPt
string
Raw patient billing value for the procedure entry.
Example
"0"
total_claims
integer
Total claims eCW reports, not just this page.
Example
0
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/ecw/fetch-claims \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"service_date":"09/27/2025","limit":6,"offset":0},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "service_date": "09/27/2025",
    "limit": 6,
    "offset": 0
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "claim_details": [
      {
        "claim": {
          "ClaimId": "9000901",
          "EncounterId": "9000001",
          "ProviderId": "9001",
          "PatientId": "900001",
          "PatientName": "Example,Jordan",
          "ServiceDate": "03/14/2026",
          "ClaimDate": "03/15/2026",
          "amount": "150.00",
          "payment": "100.00",
          "NetPayment": "100.00",
          "balance": "50.00",
          "ClaimStatus": "1",
          "ClaimStatusDesc": "Presubmission",
          "PayerName": "Example Health Plan",
          "ProviderCode": "AEX"
        },
        "icd_codes": [
          {
            "id": "9001001",
            "ItemId": "900401",
            "code": "I10",
            "name": "Essential hypertension",
            "primary": "1",
            "notes": "Confirmed during this visit.",
            "icdversion": "10"
          }
        ],
        "cpt_codes": [
          {
            "id": "9001101",
            "ItemId": "900601",
            "code": "99213",
            "name": "Office outpatient visit",
            "desc": "Established patient office visit",
            "primary": "1",
            "mod1": "25",
            "mod2": "59",
            "mod3": "RT",
            "mod4": "76",
            "sdos": "03/14/2026",
            "edos": "03/14/2026",
            "pos": "11",
            "BilledUnitFee": "150.00",
            "units": "1",
            "BilledFee": "150.00",
            "AllowedUnitFee": "110.00",
            "AllowedFee": "110.00",
            "ICD1": "1",
            "ICD2": "2",
            "ICD3": "3",
            "ICD4": "4",
            "PtPortion": "25.00",
            "BillToIns": "1",
            "BillToPt": "0"
          }
        ]
      }
    ],
    "total_claims": 0
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}