---
description: >-
  The inbound data contract. What a payer delivers to Payerbox, dataset by
  dataset and column by column, so Payerbox can build the FHIR its APIs serve.
---

> For the complete documentation index, see [llms.txt](https://www.health-samurai.io/docs/payerbox/llms.txt).
> Use it to discover all available pages before guessing URLs.

---

# Data Integration Reference

What you send Payerbox. For each USCDI data class, the columns to deliver and the FHIR they become.

```
╭─────────────╮     ╭───────────╮     ╭───────────╮     ╭───────────╮     ╭─────────────────╮
│             │     │           │     │           │     │           │     │                 │
│             │     │           │     │           │     │           │     │  Patient Access │
│ your source ├────►│ flat feed ├────►│  Payerbox ├────►│    FHIR   ├────►│ Provider Access │
│   systems   │     │           │     │ transform │     │ in Aidbox │     │  Payer-to-Payer │
│             │     │           │     │           │     │           │     │                 │
╰─────────────╯     ╰───────────╯     ╰───────────╯     ╰───────────╯     ╰─────────────────╯
```

## Data conventions

| Rule | Detail |
|---|---|
| Format | Agreed per engagement. If you deliver CSV: UTF-8, comma-delimited, RFC 4180 quoting, first row is the headers, named exactly as in the tables. |
| Delivery | Arranged per engagement. PHI: encrypted in transit and at rest under the executed BAA. |
| History (clinical feed) | Date of service on or after January 1, 2016. Send active and historical records; the status columns mark which is which. |

## Built on US Core

[USCDI](https://isp.healthit.gov/united-states-core-data-interoperability-uscdi#uscdi-v3-1) lists the data. [US Core](https://hl7.org/fhir/us/core/STU6.1/) maps each element to FHIR. Payerbox pins **US Core 6.1.0**, realizing **USCDI v3** ([Implementation Guides](../api-reference/implementation-guides.md)). This feed targets **USCDI v3.1**.

## Feeds

| Feed | Built on | Datasets |
|---|---|---|
| [Clinical Data](clinical/README.md) | US Core 6.1.0 | 24 |
| [Provider Directory](provider-directory/README.md) | PDex Plan-Net STU 1.2.0 | 4 |