Tross
EZDERM

Fetch patient claims

List a patient's claims with their procedures and diagnosis codes.

POSThttps://api.ontross.com/api/integrations/ezderm/fetch-patient-claims
Request Fields
input.patient_id
string
required
EZDerm patient UUID returned by list-patients.
Example
"00000000-0000-4000-8000-000000001001"
input.practice_id
string
EZDerm practice UUID. Resolved from the practice record when omitted.
Example
"00000000-0000-4000-8000-000000003001"
input.statuses
array
Claim statuses to include. Every status EZDerm's own search selects when omitted.
Example
["DENIED","REJECTED"]
input.limit
integer
Maximum claims to return.
Example
100
Default
100
input.sort_field
string
Field EZDerm sorts by.
Example
"dateOfService"
Default
"dateOfService"
input.sort_order
string
Sort direction.
Example
"DESC"
Default
"DESC"
Accepted values
ASCDESC
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
patient_id
string
Requested EZDerm patient UUID.
Example
"00000000-0000-4000-8000-000000001001"
count
integer
Total claims EZDerm holds for this filter.
Example
4
filtered_count
integer
Claims matching the filter before paging.
Example
4
claims
array
Claims in the requested order.
claims[].id
string
Claim UUID.
claims[].claimNumber
string
Human-facing claim number.
claims[].dateOfService
string
Service date in EZDerm's original format.
claims[].status
string
EZDerm claim status, unchanged.
claims[].patientName
string
Patient name as it appears on the claim.
claims[].providerName
string
Rendering provider name.
claims[].attendingProviderName
string
Attending provider name.
claims[].clinicName
string
Clinic the claim was billed from.
claims[].amount
integer
Claim amount as EZDerm reports it.
claims[].balance
integer
Outstanding balance as EZDerm reports it.
claims[].responsibility
string
Who EZDerm currently holds responsible.
claims[].procedures
string
Procedure codes on the claim, in EZDerm's own formatting.
claims[].icd10Codes
string
ICD-10 codes on the claim, in EZDerm's own formatting.
claims[].modifiers
string
Procedure modifiers, in EZDerm's own formatting.
claims[].active
boolean
Whether EZDerm still counts the claim as active.
Code
curl curl %s %s POST \
  --url https://api.ontross.com/api/integrations/ezderm/fetch-patient-claims \
  %s %s 'X-API-Key: REPLACE_KEY_VALUE' \
  %s %s 'content-type: application/json' \
  %s %s '{"input":{"patient_id":"00000000-0000-4000-8000-000000001001","practice_id":"00000000-0000-4000-8000-000000003001","statuses":["DENIED","REJECTED"],"limit":100,"sort_field":"dateOfService","sort_order":"DESC"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "00000000-0000-4000-8000-000000001001",
    "practice_id": "00000000-0000-4000-8000-000000003001",
    "statuses": [
      "DENIED",
      "REJECTED"
    ],
    "limit": 100,
    "sort_field": "dateOfService",
    "sort_order": "DESC"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient_id": "00000000-0000-4000-8000-000000001001",
    "count": 4,
    "filtered_count": 4,
    "claims": [
      {
        "id": "string",
        "claimNumber": "string",
        "dateOfService": "2019-08-24",
        "status": "string",
        "patientName": "string",
        "providerName": "string",
        "attendingProviderName": "string",
        "clinicName": "string",
        "amount": 0,
        "balance": 0,
        "responsibility": "string",
        "procedures": "string",
        "icd10Codes": "string",
        "modifiers": "string",
        "active": true
      }
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}