Home
API reference
FHIR® API
FHIR® resources
ClaimResponse
$status-response

ClaimResponse $status-response

post/ClaimResponse/$status-response
Page View

This resource contains claim statuses, payments, or responses. As a payer, you can use this resource to asynchronously respond to claims that were previously submitted by healthcare organizations. 

You can send payment, status updates, or other related asynchronous claim responses with this resource type.

$status-response

Respond with the status information for each line item of a previously submitted claim.

This is an asynchronous operation.

Request parameters and payload

cURL request example

bash
1
curl 'https://api.redoxengine.com/fhir/R4/{destinationSlug}/{environmentFlag}/ClaimResponse/$status-response' \
2
--request POST \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'Content-Type: application/fhir+json' \
5
--data '{
6
  "resourceType": "Bundle",
7
  "id": "InstitutionalClaimStatusCheckResponseBundle",
8
  "type": "collection",
9
  "identifier": {
10
    "system": "urn:ietf:rfc:3986",
11
    "value": "urn:uuid:59f129cf-2eca-4965-88f2-452558af1934"
12
  },
13
  "timestamp": "2021-10-21T19:09:02.452Z",
14
  "entry": [
15
    {
16
      "resource": {
17
        "resourceType": "ClaimResponse",
18
        "id": "InstitutionalClaimStatusCheckResponse",
19
        "status": "active",
20
        "use": "claim",
21
        "identifier": [
22
          {
23
            "system": "http://myclaim.id",
24
            "value": "123476789"
25
          }
26
        ],
27
        "type": {
28
          "coding": [
29
            {
30
              "code": "institutional",
31
              "system": "http://terminology.hl7.org/CodeSystem/claim-type"
32
            }
33
          ]
34
        },
35
        "patient": {
36
          "reference": "Patient/RedoxPABeneficiaryExample"
37
        },
38
        "created": "2022-01-18T16:27:49.101Z",
39
        "insurer": {
40
          "reference": "Organization/RedoxInsurerOrganizationExample"
41
        },
42
        "outcome": "partial",
43
        "insurance": [
44
          {
45
            "sequence": 1,
46
            "focal": true,
47
            "coverage": {
48
              "reference": "Coverage/RedoxPACoverageExample"
49
            }
50
          }
51
        ],
52
        "item": [
53
          {
54
            "itemSequence": 1,
55
            "id": "12387414",
56
            "adjudication": [
57
              {
58
                "category": {
59
                  "coding": [
60
                    {
61
                      "code": "A2",
62
                      "system": "https://x12.org/codes/claim-status-category-codes",
63
                      "display": "Acknowledgement/Acceptance into adjudication system"
64
                    }
65
                  ]
66
                },
67
                "reason": {
68
                  "coding": [
69
                    {
70
                      "code": "20",
71
                      "system": "https://x12.org/codes/claim-status-codes",
72
                      "display": "Accepted for processing"
73
                    }
74
                  ]
75
                }
76
              }
77
            ]
78
          },
79
          {
80
            "itemSequence": 2,
81
            "id": "5352523553",
82
            "adjudication": [
83
              {
84
                "category": {
85
                  "coding": [
86
                    {
87
                      "code": "A3",
88
                      "system": "https://x12.org/codes/claim-status-category-codes",
89
                      "display": "Acknowledgement/Returned as unprocessable claim"
90
                    }
91
                  ]
92
                },
93
                "reason": {
94
                  "coding": [
95
                    {
96
                      "code": "297",
97
                      "system": "https://x12.org/codes/claim-status-codes",
98
                      "display": "Date(s) of service"
99
                    }
100
                  ]
101
                }
102
              }
103
            ]
104
          }
105
        ]
106
      }
107
    },
108
    {
109
      "resource": {
110
        "resourceType": "Patient",
111
        "id": "RedoxPABeneficiaryExample",
112
        "identifier": [
113
          {
114
            "system": "urn:redox:MRN",
115
            "value": "M23462346"
116
          }
117
        ],
118
        "name": [
119
          {
120
            "given": [
121
              "Timothy",
122
              "Paul"
123
            ],
124
            "family": "Bixby"
125
          }
126
        ],
127
        "gender": "male",
128
        "birthDate": "2008-01-06"
129
      }
130
    },
131
    {
132
      "resource": {
133
        "resourceType": "Coverage",
134
        "id": "RedoxPACoverageExample",
135
        "class": [
136
          {
137
            "type": {
138
              "coding": [
139
                {
140
                  "code": "group",
141
                  "system": "http://terminology.hl7.org/CodeSystem/coverage-class"
142
                }
143
              ]
144
            },
145
            "value": "GRP2245"
146
          }
147
        ],
148
        "status": "active",
149
        "beneficiary": {
150
          "reference": "Patient/RedoxPABeneficiaryExample"
151
        },
152
        "payor": [
153
          {
154
            "reference": "Organization/RedoxPAInsurerOrganizationExample"
155
          }
156
        ],
157
        "subscriber": {
158
          "reference": "Patient/RedoxPABeneficiaryExample"
159
        },
160
        "subscriberId": "T75644"
161
      }
162
    },
163
    {
164
      "resource": {
165
        "resourceType": "Organization",
166
        "id": "RedoxPARequestorOrganizationExample",
167
        "active": true,
168
        "name": "Good Health Clinics",
169
        "address": [
170
          {
171
            "line": [
172
              "123 Main St."
173
            ],
174
            "city": "Madison",
175
            "district": "Dane",
176
            "state": "WI",
177
            "postalCode": "53703",
178
            "country": "USA"
179
          }
180
        ]
181
      }
182
    },
183
    {
184
      "resource": {
185
        "resourceType": "Organization",
186
        "id": "RedoxPAInsurerOrganizationExample",
187
        "active": true,
188
        "name": "Aetna",
189
        "address": [
190
          {
191
            "line": [
192
              "PO Box 14080"
193
            ],
194
            "city": "Lexington",
195
            "district": "Fayette",
196
            "state": "KY",
197
            "postalCode": "40512-4079",
198
            "country": "USA"
199
          }
200
        ]
201
      }
202
    },
203
    {
204
      "resource": {
205
        "resourceType": "Practitioner",
206
        "id": "RedoxPractitionerExamplePat",
207
        "identifier": [
208
          {
209
            "system": "http://hl7.org/fhir/sid/us-npi",
210
            "value": "4356789876"
211
          }
212
        ],
213
        "name": [
214
          {
215
            "given": [
216
              "Pat"
217
            ],
218
            "family": "Granite"
219
          }
220
        ],
221
        "address": [
222
          {
223
            "line": [
224
              "123 Main St."
225
            ],
226
            "city": "Madison",
227
            "district": "Dane",
228
            "state": "WI",
229
            "postalCode": "53703",
230
            "country": "USA"
231
          }
232
        ],
233
        "telecom": [
234
          {
235
            "value": "+16085551234"
236
          }
237
        ]
238
      }
239
    },
240
    {
241
      "resource": {
242
        "resourceType": "Practitioner",
243
        "id": "RedoxPractitionerExampleJoan",
244
        "identifier": [
245
          {
246
            "system": "http://hl7.org/fhir/sid/us-npi",
247
            "value": "4336749876"
248
          }
249
        ],
250
        "name": [
251
          {
252
            "given": [
253
              "Joan"
254
            ],
255
            "family": "Fishman"
256
          }
257
        ],
258
        "address": [
259
          {
260
            "line": [
261
              "4762 Hickory St."
262
            ],
263
            "city": "Monroe",
264
            "district": "Green",
265
            "state": "WI",
266
            "postalCode": "53566",
267
            "country": "USA"
268
          }
269
        ],
270
        "telecom": [
271
          {
272
            "value": "+16085558899"
273
          }
274
        ]
275
      }
276
    }
277
  ]
278
}'

Request Body Schema

  • 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

    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
    • resource
      required, object

      The Resource for the entry. The purpose/meaning of the resource is determined by the Bundle.type.

      • resourceType
        required, string

        Identifies the type of the resource

        Value: ClaimResponse
      • status
        required, string

        The status of the resource instance.

        Value: active
      • type
        required, object

        Type of claim. Example Codes The recommended system is http://terminology.hl7.org/CodeSystem/claim-type. Typical values include

        • pharmacy - Pharmacy claims for goods and services
        • professional - Typically outpatient claims such as Psychological, Chiropractor, rehabilitative, consulting
        • institutional - Hospital, clinic and other inpatient claims
        • coding
          Array of object

          A reference to a code defined by a terminology system.

          • system
            string

            The identification of the code system that defines the meaning of the symbol in the code.

          • code
            string

            A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

        • text
          string

          A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

      • use
        required, string

        A code to indicate whether the nature of the request is: to request adjudication of products and services previously rendered; or requesting authorization and adjudication for provision in the future; or requesting the non-binding adjudication of the listed products and services which could be provided in the future.

        Value: claim
      • patient
        required, object

        The party to whom the professional services and/or products have been supplied or are being considered and for whom actual for facast reimbursement is sought.

        Must be a resource of type Patient.

        • reference
          string

          A reference to a Patient resource

      • created
        required, string

        The date this resource was created.

      • insurer
        required, object

        The party responsible for authorization, adjudication and reimbursement.

        Must be a resource of type Organization.

        • reference
          string

          A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.

      • outcome
        required, string

        The outcome of the claim, predetermination, or preauthorization processing.

        Possible Values: queued, complete, error, partial
      • id
        string

        A response detailing the status of each line item.

      • requestor
        object

        The provider which is responsible for the claim, predetermination or preauthorization.

        Must reference one of the following types of resources:

        • Practitioner
        • Organization
        • reference
          string

          A reference to a Practitioner or Organization resource, depending on the setting.

      • item
        Array of object

        A claim line. Either a simple (a product or service) or a 'group' of details which can also be a simple items or groups of sub-details.

        • itemSequence
          required, number

          A number to uniquely reference the claim item entries.

        • adjudication
          required, Array of object

          If this item is a group then the values here are a summary of the adjudication of the detail items. If this item is a simple product or service then this is the result of the adjudication of this item.

          • category
            required, object

            A code to indicate the information type of this adjudication record. Information types may include the value submitted, maximum values or percentages allowed or payable under the plan, amounts that: the patient is responsible for in aggregate or pertaining to this item; amounts paid by other coverages; and, the benefit payable for this item.

            • coding
              Array of object

              A reference to a code defined by a terminology system.

              • system
                string

                The identification of the code system that defines the meaning of the symbol in the code.

              • code
                string

                A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

            • text
              string

              A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

          • reason
            object

            A code supporting the understanding of the adjudication result and explaining variance from expected amount.

            • coding
              Array of object

              A reference to a code defined by a terminology system.

              • system
                string

                The identification of the code system that defines the meaning of the symbol in the code.

              • code
                string

                A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

            • text
              string

              A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

      • adjudication
        Array of object

        The adjudication results which are presented at the header level rather than at the line-item or add-item levels.

        • category
          required, object

          A code to indicate the information type of this adjudication record. Information types may include the value submitted, maximum values or percentages allowed or payable under the plan, amounts that: the patient is responsible for in aggregate or pertaining to this item; amounts paid by other coverages; and, the benefit payable for this item.

          • coding
            Array of object

            A reference to a code defined by a terminology system.

            • system
              string

              The identification of the code system that defines the meaning of the symbol in the code.

            • code
              string

              A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

          • text
            string

            A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

        • reason
          object

          A code supporting the understanding of the adjudication result and explaining variance from expected amount.

          • coding
            Array of object

            A reference to a code defined by a terminology system.

            • system
              string

              The identification of the code system that defines the meaning of the symbol in the code.

            • code
              string

              A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).

          • text
            string

            A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.

      • insurance
        Array of object

        Financial instruments for reimbursement for the health care products and services specified on the claim.

        • sequence
          required, number

          A number to uniquely identify insurance entries and provide a sequence of coverages to convey coordination of benefit order.

        • focal
          required, boolean

          A flag to indicate that this Coverage is to be used for adjudication of this claim when set to true.

        • coverage
          required, object

          Reference to Coverage resource for patient.

          Must be a resource of type Coverage.

          • reference
            string

            A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with # and refers to a contained resource.

        • businessArrangement
          string

          A business agreement number established between the provider and the insurer for special business processing purposes.

Response fields and example

Example
json
1
"Operation Response"