---
title: "Create a Backfill Request"
method: POST
path: "/backfill-request"
tags: ["BackfillRequest"]
---

# Create a Backfill Request

`POST /backfill-request`

## Request

- Base URL: `https://ehr-hooks.zusapi.com`
- URL: `https://ehr-hooks.zusapi.com/backfill-request`
- Auth: none declared

API endpoint for triggering a backfill of patient data from an EHR. The backfill request pulls data such as patient demographic information and clinical data. The exact content varies by EHR.

## Request body

- object
  - `data` object
    - `type` string
    - `attributes` object
      - `ignoreRateLimit` boolean
    - `relationships` object
      - `builder` object
        - `data` object
          - `type` string
          - `id` string
      - `patient` object
        - `data` object
          - `type` string
          - `identifierSystemURL` 'https://elationemr.com/patient-id' | 'https://www.gethealthie.com' | 'https://canvasmedical.com/patient-id' | 'https://fhir.athena.io/sid/ah-patient'
          - `identifierValue` string

## Response `200`

Backfill request created successfully

- object
  - `data` object
    - `type` string
    - `id` string
    - `attributes` object
      - `status` 'success' | 'failed' | 'skipped-due-to-rate-limit'

---

[API](https://skmtc.dev/zushealth/apis/ehr-integrations.md) - [All operations](https://skmtc.dev/zushealth/apis/ehr-integrations/llms.txt) - [OpenAPI document](https://skmtc.dev/zushealth/apis/ehr-integrations/revisions/709bd7ff0ef5?raw)
