History Resource Type

The FHIR history operation allows you to retrieve the change history for all resources of a specific type. This is done using an HTTP GET request to the history endpoint for the resource type.

CLI

Retrieve the history of all Patient resources using the Haste Health CLI:

haste-health api history-type Patient "_since=2026-01-01"

This command retrieves the history of Patient resources changed since January 1, 2026.

You can also retrieve history without parameters:

haste-health api history-type Patient

TypeScript Client

Retrieve the history of all Patient resources using the TypeScript client:

import { AsynchronousClient } from '@haste-health/client';
import { R4 } from '@haste-health/fhir-types/versions';

// Assuming you have a configured client
const client: AsynchronousClient<{}> = /* ... */;

const history = await client.history_type(
  {},
  R4,
  'Patient',
  '_count=20&_since=2025-01-01'
);

console.log('Total versions:', history.total);
console.log('History entries:', history.entry);

cURL

Retrieve the history of all Patient resources using cURL:

curl -X GET "https://api.haste.health/w/[tenant]/[project]/api/v1/fhir/Patient/_history?_count=20&_since=2025-01-01" \
     -H "Content-Type: application/fhir+json" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Replace [tenant] with your tenant name and [project] with your project ID.

Error Handling

If there are any issues with the request (e.g., invalid parameters), the server will respond with an appropriate error status code and include an OperationOutcome resource in the response body.

HTTP/1.1 400 Bad Request
Content-Type: application/fhir+json

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "diagnostics": "Invalid _since parameter format"
    }
  ]
}