# List target books

`GET` `/api/v1/crm-connections/{crm_connection_id}/target-books`

Return target books for the given Salesforce CRM connection.
Supports status filtering, full-text search by name or rep, sorting, and cursor-based pagination.
Default page size is 50. Pass next_records_url from one response into the next request to
paginate through large result sets.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| status | string | no | Filter by status: Active, Deleted, or All (default: Active) |
| query | string | no | Search by target book name or active rep name |
| include_segments | boolean | no | Include segment names per target book (default: true) |
| include_reps | boolean | no | Include active rep names per target book (default: true) |
| sort_by | string | no | Field to sort by (default: Name) |
| sort_direction | string | no | Sort direction: ASC or DESC (default: ASC) |
| limit | string | no | Maximum number of target books to return (default: 50). |
| next_records_url | string | no | Cursor returned by a previous response to fetch the next page. When provided, all other query params are ignored. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| target_books | array[object] | List of target book records |
| target_books.id | string | Salesforce ID of the target book record |
| target_books.name | string | Target book name |
| target_books.status | string | Status: Active or Deleted |
| target_books.maximum_capacity | number | Maximum account capacity |
| target_books.ownership_field | string | Salesforce ownership field API name |
| target_books.created_at | string | ISO-8601 creation timestamp |
| target_books.updated_at | string | ISO-8601 last-updated timestamp |
| target_books.segments | array[object] | Segments (present when include_segments=true) |
| target_books.reps | array[object] | Active reps (present when include_reps=true) |
| next_records_url | string | Pass this value as next_records_url on the next request to fetch the following page. Null when all records have been returned. Only present when limit exceeds Salesforce's per-page maximum (2000 records). |

## Errors

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