# v1 · Venues, allocations and migrations

Paths on this page are relative to <code>/api/liquidity-studio/v1</code>. Authentication and required headers vary by operation.

[API reference overview](/api-reference/v1/overview/) · [OpenAPI download](/openapi/liquidity-studio.openapi.json)

## Operations on this page

| Method | Path | Operation |
| --- | --- | --- |
| <code>GET</code> | <code>/venues/bdex/deployments/current</code> | [getVenuesBdexDeploymentsCurrent](#getVenuesBdexDeploymentsCurrent) |
| <code>GET</code> | <code>/venues/bdex/deployments/{factoryAddress}/assessments</code> | [getVenuesBdexDeploymentsByFactoryAddressAssessments](#getVenuesBdexDeploymentsByFactoryAddressAssessments) |
| <code>POST</code> | <code>/venues/bdex/deployments/assessments</code> | [postVenuesBdexDeploymentsAssessments](#postVenuesBdexDeploymentsAssessments) |

<a id="getVenuesBdexDeploymentsCurrent"></a>

## getVenuesBdexDeploymentsCurrent

`GET /venues/bdex/deployments/current`

Operation ID: <code>getVenuesBdexDeploymentsCurrent</code>

**Authentication:** <code>&#95;&#95;Host-klineo&#95;session</code> cookie (<code>sessionCookie</code>)

This operation declares no parameters.

### Responses

| Status | Description | Content type and schema |
| --- | --- | --- |
| <code>200</code> | Successful response | <code>application/json</code>: <code>object</code> |
| <code>default</code> | Structured API error | <code>application/json</code>: [ApiErrorEnvelope](/api-reference/v1/schemas/api-error-envelope/) |

**<code>200</code> <code>application/json</code> body**

<code>object</code>

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>data</code> | Yes | <code>object</code> | The typed runtime domain record returned by this operation. Additional properties allowed |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

<a id="getVenuesBdexDeploymentsByFactoryAddressAssessments"></a>

## getVenuesBdexDeploymentsByFactoryAddressAssessments

`GET /venues/bdex/deployments/{factoryAddress}/assessments`

Operation ID: <code>getVenuesBdexDeploymentsByFactoryAddressAssessments</code>

**Authentication:** <code>&#95;&#95;Host-klineo&#95;session</code> cookie (<code>sessionCookie</code>)

### Parameters

| Name | Location | Required | Type | Description and constraints |
| --- | --- | --- | --- | --- |
| <code>factoryAddress</code> | path | Yes | <code>string</code> | Min length: <code>1</code> |

### Responses

| Status | Description | Content type and schema |
| --- | --- | --- |
| <code>200</code> | Successful response | <code>application/json</code>: <code>object</code> |
| <code>default</code> | Structured API error | <code>application/json</code>: [ApiErrorEnvelope](/api-reference/v1/schemas/api-error-envelope/) |

**<code>200</code> <code>application/json</code> body**

<code>object</code>

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>data</code> | Yes | <code>object</code> | The typed runtime domain record returned by this operation. Additional properties allowed |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

<a id="postVenuesBdexDeploymentsAssessments"></a>

## postVenuesBdexDeploymentsAssessments

`POST /venues/bdex/deployments/assessments`

Operation ID: <code>postVenuesBdexDeploymentsAssessments</code>

**Authentication:** <code>&#95;&#95;Host-klineo&#95;session</code> cookie (<code>sessionCookie</code>)

### Parameters

| Name | Location | Required | Type | Description and constraints |
| --- | --- | --- | --- | --- |
| <code>Idempotency-Key</code> | header | Yes | <code>string</code> | Min length: <code>8</code>; Max length: <code>163</code> |

### Request body

Required: **yes**.

**<code>application/json</code>**

<code>object</code> — Additional properties rejected

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>factoryAddress</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-fA-F&#93;{40}$</code> |
| <code>reason</code> | Yes | <code>string</code> | Min length: <code>12</code>; Max length: <code>500</code> |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

### Responses

| Status | Description | Content type and schema |
| --- | --- | --- |
| <code>201</code> | Successful response | <code>application/json</code>: <code>object</code> |
| <code>default</code> | Structured API error | <code>application/json</code>: [ApiErrorEnvelope](/api-reference/v1/schemas/api-error-envelope/) |

**<code>201</code> <code>application/json</code> body**

<code>object</code>

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>data</code> | Yes | <code>object</code> | The typed runtime domain record returned by this operation. Additional properties allowed |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.