Claim $inquiry

post/Claim/$inquiry

Page View

This resource contains the financial details for provider services for a patient visit or treatment. Healthcare organizations can use this resource to request reimbursement, while payers can review this resource to process claims and respond with the ClaimResponse resource.

You can submit, check, or add to claim information using one of the supported operations.

Supported fields

We support any valid FHIR® field. However, we only display the fields that we’ve defined in the schema, which are usually based on what’s included in the U.S. Core profile.

$inquiry

Check the status of a previously submitted preauthorization request.

We support this operation for completeness and compliance with the DaVinci PAS specification. However, we recommend using the $status operation for clarity.

If you choose this operation, you may use the data-absent-reason extension for required fields like patient. This allows you to quickly check the status of a claim with only the Claim.identifier. You can also optionally add an administrativeReferenceNumber in the Claim.item.extension.

Request parameters and payload

cURL request example

bash

1
curl 'https://api.redoxengine.com/fhir/R4/{destinationSlug}/{environmentFlag}/Claim/$inquiry' \
2
--request POST \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'Content-Type: application/fhir+json' \
5
--data '{
6
  "resourceType": "Bundle",
7
  "id": "RedoxMedicationClaimInquiryBundleExample",
8
  "type": "collection",
9
  "identifier": {
10
    "system": "urn:ietf:rfc:3986",
11
    "value": "urn:uuid:0825e908-b107-4958-b333-9ebc090f1ab6"
12
  },
13
  "timestamp": "2021-09-10T17:30:13.303Z",
14
  "entry": [
15
    {
16
      "resource": {
17
        "resourceType": "Claim",
18
        "id": "RedoxPAMedicationClaimInquiryExample",
19
        "status": "active",
20
        "use": "preauthorization",
21
        "insurance": [
22
          {
23
            "focal": true,
24
            "sequence": 1,
25
            "coverage": {
26
              "extension": [
27
                {
28
                  "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
29
                  "valueCode": "unsupported"
30
                }
31
              ]
32
            }
33
          }
34
        ],
35
        "item": [
36
          {
37
            "extension": [
38
              {
39
                "url": "http://hl7.org/fhir/us/davinci-pas/StructureDefinition/extension-administrationReferenceNumber",
40
                "valueString": "REF456"
41
              }
42
            ],
43
            "sequence": 1,
44
            "productOrService": {
45
              "extension": [
46
                {
47
                  "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
48
                  "valueCode": "unsupported"
49
                }
50
              ]
51
            }
52
          }
53
        ],
54
        "identifier": [
55
          {
56
            "type": {
57
              "coding": [
58
                {
59
                  "code": "ClaimID"
60
                }
61
              ]
62
            },
63
            "value": "urn:uuid:97b8d6d0-ac3d-411a-b32a-e1d237aceb6a"
64
          }
65
        ],
66
        "type": {
67
          "coding": [
68
            {
69
              "code": "pharmacy",
70
              "system": "http://terminology.hl7.org/CodeSystem/claim-type"
71
            }
72
          ]
73
        },
74
        "created": "2021-08-18T16:27:49.101Z",
75
        "priority": {
76
          "coding": [
77
            {
78
              "code": "normal",
79
              "system": "http://terminology.hl7.org/CodeSystem/processpriority"
80
            }
81
          ]
82
        },
83
        "patient": {
84
          "extension": [
85
            {
86
              "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
87
              "valueCode": "unsupported"
88
            }
89
          ]
90
        },
91
        "insurer": {
92
          "extension": [
93
            {
94
              "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
95
              "valueCode": "unsupported"
96
            }
97
          ]
98
        },
99
        "provider": {
100
          "extension": [
101
            {
102
              "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
103
              "valueCode": "unsupported"
104
            }
105
          ]
106
        }
107
      }
108
    }
109
  ]
110
}'

Request Body Schema

resourceType
required, string
Identifies the type of the resource
Value: Bundle
identifier
required, object
A persistent identifier for the bundle that won't change as a bundle is copied from server to server.
- system
  string
  Establishes the namespace for the value - that is, a URL that describes a set values that are unique.
- value
  string
  The portion of the identifier typically relevant to the user and which is unique within the context of the system.
type
required, string
Indicates the purpose of this bundle - how it is intended to be used.
Value: collection
timestamp
required, string
The date/time that the bundle was assembled - i.e. when the resources were placed in the bundle.
entry
required, Array of Claim, Patient, MedicationRequest, ServiceRequest, Coverage, Organization, PractitionerRole, Practitioner, RelatedPerson, DocumentReference or Other
When inquiring about the status of previously requested claim, the only resource and field explicity required is the Claim.identifier which is used to look up the original claim.

Additional resources relating to the claim may also be sent, but most are unnecessary as long as the identifier is present.

Response fields and example

json

1
{}

resourceType
required, string
Identifies the type of the resource
Value: Bundle
type
required, string
Indicates the purpose of this bundle - how it is intended to be used.
Value: collection
entry
required, Array of ClaimResponse, Patient, Coverage, Location, Practitioner, RelatedPerson or Other
An array of FHIR resources. At a minimum, a the claim status response should include the following entries:
- ClaimResponse - the most important part of the request - contains references to all other resources, details adjudication at the appropriate levels.
- Patient - the patient the claim is for.
- Organization - at least one resource representing the party responsible for making the claim. Additional organization resources may carry information such as pharmacy, payor, or policy holder.
- Practitioner - for professional claims the provider submitting the claim
- Coverage - the patient's insurance

FHIR® is a registered trademark of Health Level Seven International (HL7) and is used with the permission of HL7. Use of this trademark does not constitute an endorsement of products/services by HL7®.