History System

The FHIR system-level history operation allows you to retrieve the change history for all resources across all resource types on the FHIR server. This is done using an HTTP GET request to the system history endpoint.

CLI

Retrieve the system-wide history using the Haste Health CLI:

haste-health api history-system "_count=50&_since=2025-01-01"

This command retrieves the last 50 resource versions across all types changed since January 1, 2025.

You can also retrieve history without parameters:

haste-health api history-system r4

TypeScript Client

Retrieve the system-wide history 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_system(
  {},
  R4,
  '_count=50&_since=2025-01-01'
);

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

cURL

Retrieve the system-wide history using cURL:

curl -X GET "https://api.haste.health/w/[tenant]/[project]/api/v1/fhir/r4/_history?_count=50&_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"
    }
  ]
}