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

# Worked request and response samples

> Worked samples for CDP identity resolution and profile lookups, plus the reverse-ETL access note that also lives below.

<Note>
  **Access note for the BigQuery reverse-ETL config endpoints** — `GET /api/v1/cdp/reverse-etl` and `PATCH /api/v1/cdp/reverse-etl` accept the **developer** role in addition to owner / admin. The generated per-operation descriptions below may still say "Owner / admin only" because they aren't annotated in the route schema yet; this overlay is the authoritative source until they are.
</Note>

## Worked request and response samples

Copy a request body as written, substitute your own ids, and compare the response envelope. Errors follow Devotel Orbit's `{ error, meta }` envelope, shown once below under **Error envelope**.

### Resolve an identity

<Note>
  `GET /api/v1/cdp/identity-resolution/rules`
</Note>

Returns the identity-resolution rules that map the inputs you provide (anonymous\_id, email, phone, user\_id) onto a single profile.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "rule": "email",
        "priority": 10,
        "match": "exact"
      }
    ],
    "meta": {
      "request_id": "req_cdp_rules",
      "timestamp": "2026-08-01T12:00:00.000Z"
    }
  }
  ```
</ResponseExample>

### Get a profile's resolved traits by email

<Note>
  `GET /api/v1/cdp/profiles/by-email/{email}/traits`
</Note>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "first_name": "Jane",
      "company": "Acme Inc"
    },
    "meta": {
      "request_id": "req_cdp_traits",
      "timestamp": "2026-08-01T12:01:00.000Z"
    }
  }
  ```
</ResponseExample>

### Error envelope

```json 422 theme={null}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "status": 422,
    "message": "email: Required"
  },
  "meta": {
    "request_id": "req_...",
    "timestamp": "2026-08-01T12:00:00.000Z"
  }
}
```