Coverage
Overview
The Coverage resource provides information about insurance or payment for healthcare services. This includes details about the insurance plan, policy holder, and coverage benefits.
Resource Schema
Key fields in the Coverage resource:
{
"resourceType": "Coverage",
"id": "example-coverage-123",
"status": "active",
"type": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "EHCPOL",
"display": "extended healthcare"
}
]
},
"subscriber": {
"reference": "Patient/123456"
},
"beneficiary": {
"reference": "Patient/123456"
},
"relationship": {
"coding": [
{
"code": "self"
}
]
},
"period": {
"start": "2023-01-01",
"end": "2023-12-31"
},
"payor": [
{
"reference": "Organization/insurance-789"
}
]
}
Operations
The Coverage resource supports Read and Search operations. Support varies by CareRecord solution.
| CareRecord / Solution | Read | Search |
|---|---|---|
| GEHRIMED | ✅ | ✅ |
| myAvatar | ✅ | ✅ |
| myEvolv | ✅ | ✅ |
| myUnity | ✅ | ✅ |
| TheraOffice | ✅ | ✅ |
Read
HTTP Method: GET
URL: /Coverage/{id}
- Production
- Preview
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Coverage/123456 \
-H "Authorization: Bearer {token}" \
-H "Accept: application/fhir+json"
curl -X GET https://fhirtest.netsmartcloud.com/uscore/v1/Coverage/123456 \
-H "Authorization: Bearer {token}" \
-H "Accept: application/fhir+json"
Search
HTTP Method: GET or POST
URL: /Coverage or /Coverage/_search
- Production
- Preview
Search by Patient
curl -X POST https://fhir.netsmartcloud.com/uscore/v1/Coverage/_search \
-H "Authorization: Bearer {token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "patient=Patient/123"
Search by Patient
curl -X POST https://fhirtest.netsmartcloud.com/uscore/v1/Coverage/_search \
-H "Authorization: Bearer {token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "patient=Patient/123"
Integration Patterns
Common Workflows
- Insurance Verification - Verify patient insurance coverage
- Benefits Checking - Determine coverage benefits and limitations
- Claims Processing - Support insurance claims and billing
Relationships to Other Resources
- Patient - Beneficiary of the insurance coverage
- Organization - Insurance companies providing coverage
- ExplanationOfBenefit - Claims processed under this coverage
Error Handling
For common errors and troubleshooting guidance, see Common Errors.