# Get rep

`GET` `/api/v1/crm-connections/{crm_connection_id}/bookbuilder/reps/{rep_id}`

Returns the rep's active target-book assignment. A user can only be
actively assigned to one target book at a time, so the match is
unambiguous. Returns 404 if the user has no active assignment. Pass
``metrics`` with ``start_date`` and ``end_date`` to include per-rep
metrics; supported metric names match GET /bookbuilder/reps.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| rep_id | string | yes | Salesforce User ID of the rep |

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| metrics | string | no | Comma-separated list of metric names to include (up to 20). Alternatively, pass a single category token — `all_accounts`, `on_book`, or `off_book` — to request every metric in that category. Category tokens cannot be combined with other tokens. Requires start_date and end_date. When omitted, the `metrics` field is null in the response. Supported metric names match GET /bookbuilder/reps. |
| start_date | string | no | Start of the metrics window (inclusive), formatted as YYYY-MM-DD. Required when metrics is set. |
| end_date | string | no | End of the metrics window (inclusive), formatted as YYYY-MM-DD. Required when metrics is set. |
| hierarchy_rollup_enabled | string | no | When true, expands metrics to include child accounts via the org's configured account hierarchy. Returns 400 if account hierarchy is not configured in the Salesforce org. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Salesforce User ID of the rep |
| name | string | User.Name |
| is_active | boolean | User.IsActive |
| role | object | User.UserRole, if assigned |
| role.id | string | — |
| role.name | string | — |
| profile | object | User.Profile, if any |
| profile.id | string | — |
| profile.name | string | — |
| manager | object | User.Manager, if assigned |
| manager.id | string | — |
| manager.name | string | — |
| target_book | object | — |
| target_book.id | string | — |
| target_book.name | string | — |
| metrics | object | Requested metrics keyed by metric name. Null when the caller did not request metrics. Individual values may be null for threshold-dependent metrics when the target book has no Activity Threshold configured. |

## Errors

| Status | Description |
|--------|-------------|
| 400 | Bad Request |
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Unprocessable Entity |
| 502 | Bad Gateway |