# Get retrieval

`GET` `/api/v1/crm-connections/{crm_connection_id}/retrievals/{retrieval_id}`

Returns the full configuration for a retrieval definition or template,
including conditions, ranking criteria, update fields, retrieve-from
sources, and schedule info.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| retrieval_id | string | yes | Salesforce ID of the retrieval definition |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Salesforce ID of the retrieval definition |
| name | string | Retrieval name |
| status | string | Status: Active or Deleted |
| is_template | boolean | Whether this is a template definition |
| ownership_field | string | Salesforce field API name for ownership assignment |
| max_retrieval_amount | number | Maximum number of records to retrieve per source |
| retrieval_type | string | Retrieval type: On Book or Off Book |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-updated timestamp |
| retrieve_from | array[object] | Sources to retrieve from: active reps or active target books |
| retrieve_from.type | string | Source type: 'Rep' or 'Target Book' |
| retrieve_from.id | string | Salesforce ID of the source |
| retrieve_from.name | string | Display name |
| conditions_operator | string | How conditions are combined: AND, OR, or CUSTOM |
| custom_condition_logic | string | Custom condition expression (e.g. '1 AND (2 OR 3)'), present when conditions_operator is CUSTOM |
| conditions | array[object] | Eligibility conditions |
| conditions.id | string | Salesforce ID of the condition record |
| conditions.number | integer | Condition number, used in custom expressions |
| conditions.field | string | Salesforce field API name |
| conditions.operator | string | Comparison operator |
| conditions.value | string | Value to compare against |
| ranking | array[object] | Ranking criteria |
| ranking.id | string | Salesforce ID of the ranking condition |
| ranking.number | integer | Ranking position number |
| ranking.field | string | Salesforce field API name to rank by |
| ranking.order | string | Sort order: ASC or DESC |
| update_fields | array[object] | Fields to update on retrieved records |
| update_fields.id | string | Salesforce ID of the field record |
| update_fields.name | string | Salesforce field API name to update |
| update_fields.value | string | Value to set |
| update_fields.data_type | string | Data type of the field |
| schedule | object | Schedule configuration (null if no schedule) |
| schedule.type | string | Schedule type: 'one_time' or 'recurring' |
| schedule.next_run_time | string | ISO-8601 next scheduled run time |
| schedule.interval | integer | Recurrence interval (only for recurring) |
| schedule.interval_type | string | Recurrence interval unit, e.g. 'Days' (only for recurring) |
| schedule.enabled | boolean | Whether the recurring schedule is active (only for recurring) |
| new_owners | array[object] | New owners: account pool users when source is ACCOUNT_POOL, the configured source user when source is USER, null otherwise |

## Errors

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