> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chift.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Raw data & pass-through

> Extending the Unified API when you need more control

The Unified API covers most standard use cases.\
When it doesn’t, Chift provides two advanced escape hatches:

* **Raw data**: access the native API responses used to build unified objects
* **Pass-through**: call connector-specific endpoints directly

These features allow you to go beyond the unified model while still benefiting from Chift’s authentication, routing, and connector maintenance.

## Raw data

### What it is

The *Raw Data* feature exposes the native API calls and responses used internally by Chift to build unified data.

You still receive the unified response, with an additional `raw_data` field containing everything fetched behind the scenes.

### When to use it

* You need fields not exposed in the unified model
* You want to understand or debug how unified data is built
* You want to enrich unified objects with connector-specific fields

### How to use it

Add the following header to your request:

```text theme={null}
X-Chift-Raw-Data: true
```

For example, `/pos/customers` returns the unified data along with a `raw_data` field containing the endpoints called and their results.

```text theme={null}
{
  "items": [
    {
      "id": "168390",
      "first_name": "Henry",
      "last_name": "Michel",
      "name": "Henry Michel",
      "phone": null,
      "email": null,
      "created_on": "2016-01-13T10:05:10+01:00",
      "addresses": [],
      "loyalty": 0,
      "birthdate": null
    },
    ...
  ],
  "page": 1,
  "total": 1005,
  "raw_data": {
    "customers?offset=9000&limit=1000": {
      "customers": [
        {
          "id": 24909902
          ...
        }
      ]
    }
  }
}
```

<Info>
  When using the API Explorer in your Chift Platform, you have a checkbox to activate the "raw data" feature to test it out.
</Info>

## Pass-through

### What it is

Pass-through lets you call connector-specific API routes that are not exposed through the Unified API.

Chift handles authentication, connection management and forwards your request to the connector.\
You directly interact with the connector’s native endpoint and response format.

### When to use it

Use pass-through when:

* The Unified API does not expose a required feature
* The connector provides useful routes (e.g. promotions, reports, exports)
* You need immediate access without waiting for unification

If the endpoint can be unified, prefer the Unified API.

### How it works

To call a connector's native endpoint, insert `forward` between the Unified API name and the endpoint path:

```http theme={null}
GET /consumers/{consumerId}/{unified_api}/forward/{endpoint_path}
```

**Example** — retrieving the list of promotions from a POS connector:

```http theme={null}
GET /consumers/{consumerId}/pos/forward/promotions
```

Chift handles authentication and forwards the request to the connector's native API. All query parameters and request options are passed through as-is.

<Warning>
  This is not yet implemented on all connectors (and is as well not supported for all connectors). Please contact the support or your CSM if needed.
</Warning>