# Get distribution

`GET` `/api/v1/crm-connections/{crm_connection_id}/distributions/{distribution_id}`

Returns the full configuration for a distribution definition or template,
including conditions, ranking criteria, update fields, recipients, and
schedule info.

## Path parameters

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

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Salesforce ID of the distribution definition |
| name | string | Distribution name |
| status | string | Status: Active or Deleted |
| is_template | boolean | Whether this is a template definition |
| distribution_type | string | Distribution method, e.g. Round Robin |
| distribution_amount | number | Number of records to distribute per recipient |
| source | string | Record source, e.g. ACCOUNT_POOL or USER |
| created_at | string | ISO-8601 creation timestamp |
| updated_at | string | ISO-8601 last-updated timestamp |
| recipients | array[object] | Recipients: active reps or active target books |
| recipients.type | string | Recipient type: 'Rep' or 'Target Book' |
| recipients.id | string | Salesforce ID of the recipient |
| recipients.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 distributed 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) |
| gw_list | object | Linked Gradient Works list (null if none) |
| gw_list.id | string | Gradient Works list ID |
| gw_list.name | string | List name |
| gw_list.source | string | List source |
| source_users | array[object] | Source users: account pool users when source is ACCOUNT_POOL, the single source user when source is USER, null otherwise |
| assignment_order | object | Round-robin assignment order with next-up indicator (null if no round-robin entries exist) |
| assignment_order.start_position | integer | 1-based position of the next rep to be assigned |
| assignment_order.entries | array[object] | Ordered list of reps in assignment order |
| assignment_order.entries.position | integer | 1-based position in the assignment order |
| assignment_order.entries.rep | string | Rep display name |
| assignment_order.entries.target_book | string | Target book name |

## Errors

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