Healthcare API Test-Case Pack
FHIR R4 resources and search, SMART on FHIR scopes, consent, eligibility and benefits, claims and HL7 v2 messaging
What's inside:
For: QA and integration teams at payers, providers and health-tech vendors
Get your free copy
Enter your email and we'll send the download link to your inbox.
Preview: Healthcare API Test-Case Pack
This page shows roughly the first 20% of the pack so you can judge it before you download. The full ZIP contains 5 files: healthcare-api-test-cases.csv, healthcare-api-test-cases-guide.pdf, healthcare-api-test-cases-guide.md, deployment-audit-checklist.csv, self-hosted-api-testing-deployment-checklist.pdf.
About this pack
Healthcare APIs are standards-heavy and access-sensitive. Most defects that matter are either a standard applied loosely (a search that ignores a parameter, an update that overwrites a newer version) or an access rule that holds for one patient and fails for the next. These cases cover both.
healthcare-api-test-cases.csv has 31 cases. Each names the domain area, the request, the expected result, a type, a priority and the public standard or document it was written against. Replace placeholders in {braces} with your own paths, identifiers and data.
Areas covered
| Domain area | Cases |
|---|---|
| FHIR server | 2 |
| Patient | 11 |
| Observation | 2 |
| Encounter | 1 |
| Minimum necessary | 1 |
| SMART on FHIR | 4 |
| Consent | 1 |
| Audit | 1 |
| Eligibility and benefits | 3 |
| Claims | 1 |
| HL7 v2 over HTTP | 3 |
| Data protection | 1 |
Healthcare API test cases
healthcare-api-test-cases.csv · showing 7 of 31 rows. FHIR R4, SMART on FHIR, consent, eligibility, claims and HL7 v2.
HC-001
CapabilityStatement is published
- Domain Area
- FHIR server
- Preconditions
- FHIR R4 endpoint
- Input / Request
- GET [base]/metadata
- Expected Result
- 200; resourceType CapabilityStatement; fhirVersion 4.0.1; supported resources and search parameters listed
- Type
- Positive
- Priority
- P2
- Reference
- HL7 FHIR R4 RESTful API
HC-002
FHIR JSON content type is honoured
- Domain Area
- FHIR server
- Preconditions
- -
- Input / Request
- GET [base]/Patient/{id} with Accept: application/fhir+json
- Expected Result
- Content-Type application/fhir+json; valid FHIR JSON
- Type
- Positive
- Priority
- P2
- Reference
- HL7 FHIR R4 RESTful API
HC-003
Read an existing Patient
- Domain Area
- Patient
- Preconditions
- Patient {id} exists
- Input / Request
- GET [base]/Patient/{id}
- Expected Result
- 200; resourceType Patient; id matches; meta.versionId and meta.lastUpdated present
- Type
- Positive
- Priority
- P1
- Reference
- HL7 FHIR R4 Patient
HC-004
Unknown Patient id
- Domain Area
- Patient
- Preconditions
- -
- Input / Request
- GET [base]/Patient/does-not-exist
- Expected Result
- 404 with an OperationOutcome
- Type
- Negative
- Priority
- P2
- Reference
- HL7 FHIR R4 RESTful API
HC-005
Deleted Patient returns Gone
- Domain Area
- Patient
- Preconditions
- Patient deleted (if the server supports delete)
- Input / Request
- GET [base]/Patient/{deleted id}
- Expected Result
- 410 Gone
- Type
- Negative
- Priority
- P3
- Reference
- HL7 FHIR R4 RESTful API
HC-006
Search by family name and birth date
- Domain Area
- Patient
- Preconditions
- Patients with known demographics
- Input / Request
- GET [base]/Patient?family={family}&birthdate={yyyy-mm-dd}
- Expected Result
- 200; Bundle type searchset; only matching patients; entry.search.mode = match
- Type
- Positive
- Priority
- P1
- Reference
- HL7 FHIR R4 Search
HC-007
Search by identifier system and value
- Domain Area
- Patient
- Preconditions
- Patient with an MRN identifier
- Input / Request
- GET [base]/Patient?identifier={system}|{value}
- Expected Result
- Exactly the matching patient
- Type
- Positive
- Priority
- P1
- Reference
- HL7 FHIR R4 Search (token)
The rest of the pack
71 rows across 2 CSV files, and all 6 sections of the guide as PDF and Markdown. Enter your work email above and we will send the download link.
Want to automate your API testing?
Generate tests from OpenAPI specs, run in CI/CD, and scale quality across teams.