# AllocationPlanCandidate

[All API schemas](/api-reference/schemas/)

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>candidateId</code> | Yes | <code>string</code> | — |
| <code>objective</code> | Yes | <code>string</code> | Allowed: <code>BALANCED</code>, <code>EXECUTION&#95;QUALITY</code>, <code>CAPITAL&#95;EFFICIENCY</code>, <code>RISK&#95;MINIMIZED</code>, <code>EXIT&#95;FLEXIBILITY</code> |
| <code>allocations</code> | Yes | Array of [VenueAllocation](/api-reference/schemas/venue-allocation/) | — |
| <code>scoreVector</code> | Yes | [AllocationScoreVector](/api-reference/schemas/allocation-score-vector/) | — |
| <code>aggregateScorePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>confidencePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>executionClass</code> | Yes | <code>string</code> | Allowed: <code>PREVIEW&#95;ONLY</code>, <code>BDEX&#95;TYPED&#95;EXECUTABLE</code> |

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

Exact definition: <code>#/components/schemas/AllocationPlanCandidate</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).