# Get flow version

`GET` `/api/v1/crm-connections/{crm_connection_id}/flows/{flow_id}/versions/{version_id}`

Return the full configuration for a specific flow version, including its
Metadata JSON. By default, null fields and empty lists are stripped from
the metadata response. Set simplified=false to receive the unprocessed metadata.

## Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| crm_connection_id | string | yes | UUID of the CRM connection |
| flow_id | string | yes | DurableId of the flow definition |
| version_id | string | yes | DurableId of the flow version, as returned in the durable_id field of list_flow_versions |

## Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| simplified | boolean | no | When true (default), null fields and empty lists are stripped from the metadata response, producing a leaner representation. Set to false to receive the unprocessed metadata. |

## Response

`200 OK` — `application/json`

| Field | Type | Description |
|-------|------|-------------|
| id | string | Flow version record ID |
| api_version | number | API version that defines the execution behavior of the flow |
| definition_id | string | ID of the parent FlowDefinition record |
| description | string | Description of the flow version |
| environments | string | Where the flow can run (e.g. Default, Offline, Slack). Multipicklist value. |
| full_name | string | Fully qualified API name of the flow version (e.g. MyFlow-3) |
| is_template | boolean | Whether the flow is a template |
| manageable_state | string | Managed package state of the component. One of: beta, deleted, deprecated, deprecatedEditable, installed, installedEditable, released, unmanaged |
| master_label | string | Display label for the flow version |
| metadata | string | Full flow version configuration. Null for flows in managed packages (unless they are templates). |
| process_type | string | Type of flow (e.g. Flow, AutoLaunchedFlow, Workflow, InvocableProcess) |
| run_in_mode | string | Run mode: DefaultMode, SystemModeWithSharing, or SystemModeWithoutSharing |
| status | string | Version status: Active, Draft, Obsolete, UnderReview, or InvalidDraft |
| time_zone_sid_key | string | Time zone ID in which the flow runs |
| version_number | integer | Version number |

## Errors

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