> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Migration Split

> Check how much of a V1 pathway's traffic goes to a V2 agent.

Returns the migration split on a V1 pathway, or `null` when the pathway has none. A split sends a share of the pathway's inbound calls, [Send Call](https://docs.bland.ai/api-v1/post/calls.md) requests, and new text conversations to a V2 agent. [Set Migration Split](https://docs.bland.ai/api-v1/put/convo-pathway-id-migration-split.md) describes exactly which traffic it routes. A split at `0%` still exists and is returned.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Path Parameters

**pathway\_id** `string` *required*

The V1 pathway. Must be a UUID of a pathway in your organization. Returns `400 BAD_REQUEST` for an invalid UUID, `404 NOT_FOUND` for a pathway outside your organization, and `400 BAD_REQUEST` for a pathway that Bland compiled from a V2 agent.

### Response

**data.migration\_split** `object | null`

The pathway's split, or `null` when it has none.

**migration split object**

**agent\_id** `string`

The agent that receives the split traffic.

**v2\_percentage** `integer`

Percentage of the pathway's traffic sent to the agent, `0` to `100`.

**request\_policy** `string`

`honor` (the request's call settings win) or `agent_owned` (the agent's settings win). See [Set Migration Split](https://docs.bland.ai/api-v1/put/convo-pathway-id-migration-split.md).

**updated\_at** `string`

ISO 8601 timestamp of the last change.

**rollout\_id** `string | null`

ID of the rollout that is moving this pathway's share, or `null` when no rollout is in progress. A paused rollout still counts as in progress. While it is set, a [Set Migration Split](https://docs.bland.ai/api-v1/put/convo-pathway-id-migration-split.md) request with a share above `0` returns `409 ROLLOUT_IN_PROGRESS`.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "data": {
    "migration_split": {
      "agent_id": "6f2c8a41-3b7e-4d19-9c55-0e8a1f3b7d24",
      "v2_percentage": 25,
      "request_policy": "honor",
      "updated_at": "2026-11-12T18:04:51.220Z",
      "rollout_id": null
    }
  },
  "errors": null
}
```

```json No Split theme={null}
{
  "data": {
    "migration_split": null
  },
  "errors": null
}
```

```json Pathway Not Found theme={null}
{
  "data": null,
  "errors": [
    {
      "error": "NOT_FOUND",
      "message": "Pathway not found"
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.