> ## Documentation Index > Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt > Use this file to discover all available pages before exploring further. # Get capacity availability > Find which Availability Zones are most likely to support the instance types and Node counts you request. {/* Keep in sync with public-docs/snippets/capacity-finder-confidentiality-banner.mdx (legal notice requested by the product team). */} } color="#1326E1"> This documentation describes CoreWeave's ("CW") Capacity Finder product (delivered via console or API). Data, content, images, links and other information generated by or accessed in relation to Capacity Finder constitutes CW's property and confidential information ("Capacity Data"). Do not share such Capacity Data, including without limitation screenshots, exports, API responses, or related links outside your company.
To the extent your company's agreement(s) with CW include confidentiality obligations, the Capacity Data is confidential thereunder; otherwise, you agree to keep it confidential and not disclose it without CW's prior written consent. The Capacity Data is provided for general informational purposes only, without warranty, and to the maximum extent permitted by law, CW disclaims liability arising from its use, including any reliance on it for capacity planning, purchasing, or other business decisions. Any agreement(s) between your company and CW shall govern in the event of any conflict with this notice. For request guidance and result interpretation, see the [Capacity Finder API overview](/platform/capacity-plans/capacity-finder-api). Authenticate with a [CoreWeave API access token](/security/authn-authz/manage-api-access-tokens) in the `Authorization: Bearer [API-ACCESS-TOKEN]` header. Capacity Finder requires an authenticated organization but no additional Capacity Finder-specific role or permission. Send at least one selection and exactly one capacity plan, `CAPACITY_PLAN_SPOT`, the only supported plan. Each selection must use a distinct instance type and a positive whole-number Node count. Encode `requestedCount` as a JSON integer, such as `8`, up to `2147483647`. Scores reflect cached capacity. Higher scores indicate more favorable availability. They do not reserve Nodes or guarantee provisioning. When the score is `0`, the response omits the `score` field from that result. ## OpenAPI ````yaml /openapi/capacity-finder/openapi.yaml post /v1beta1/capacity/availability:get openapi: 3.0.3 info: title: CoreWeave Capacity Finder API description: >- Find which Availability Zones are most likely to support your capacity needs before you create a Spot Node Pool. version: 0.0.1 servers: - url: https://api.coreweave.com description: CoreWeave API gateway. security: - bearerAuth: [] tags: - name: CapacityService description: Compare capacity for instance types and requested Node counts. x-group: CapacityService paths: /v1beta1/capacity/availability:get: post: tags: - CapacityService summary: Get capacity availability description: >- Ranks eligible availability zones for the requested instance types and node counts. Results reflect cached capacity and do not reserve nodes or guarantee placement. An unknown instance type fails the request with `NotFound`. The service returns `Unavailable` until capacity data is ready and `InvalidArgument` for invalid requests. operationId: CapacityService_GetCapacityAvailability requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/coreweave.capacity.v1beta1.GetCapacityAvailabilityRequest example: selections: - instanceType: gd-8xh100ib-i128 requestedCount: 8 capacityPlans: - CAPACITY_PLAN_SPOT zones: - US-EAST-04A responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/coreweave.capacity.v1beta1.GetCapacityAvailabilityResponse example: results: - zone: US-EAST-04A score: 0.8 instanceType: gd-8xh100ib-i128 capacityPlan: CAPACITY_PLAN_SPOT default: description: Default error response content: application/json: schema: $ref: '#/components/schemas/google.rpc.Status' components: schemas: coreweave.capacity.v1beta1.GetCapacityAvailabilityRequest: description: GetCapacityAvailabilityRequest defines the capacity options to evaluate. type: object properties: zones: description: >- Limits the evaluation to these availability zones. Omit the list or send an empty list to evaluate all eligible zones. Ineligible zones are ignored and duplicate zones are evaluated once. No eligible matches is a successful empty result. type: array items: type: string capacityPlans: description: >- Exactly one capacity plan is required. Send `CAPACITY_PLAN_SPOT`, the only supported plan. type: array items: type: string format: enum enum: - CAPACITY_PLAN_SPOT selections: description: >- At least one instance type and requested node count is required. Each instance type must occur at most once, even when the requested counts differ. type: array items: $ref: '#/components/schemas/coreweave.capacity.v1beta1.CapacitySelection' required: - capacityPlans - selections coreweave.capacity.v1beta1.GetCapacityAvailabilityResponse: description: GetCapacityAvailabilityResponse contains ranked availability results. type: object properties: results: description: >- Ordered by descending score, then by instance type and zone. Each result represents one zone, instance type, and capacity plan. A selection without matching cached capacity contributes no results. An empty result is successful. Do not expect a result for every requested zone and instance type. type: array items: $ref: >- #/components/schemas/coreweave.capacity.v1beta1.CapacityAvailabilityResult google.rpc.Status: description: >- The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). type: object properties: code: description: The numeric Google RPC status code. type: integer format: int32 message: description: >- A developer-facing error message. Structured error information can appear in `details`. type: string details: description: >- A list of messages that carry the error details. There is a common set of message types for APIs to use. type: array items: $ref: '#/components/schemas/google.protobuf.Any' coreweave.capacity.v1beta1.CapacitySelection: description: CapacitySelection pairs an instance type with its requested node count. type: object properties: instanceType: description: >- The CoreWeave instance type to evaluate. Must be nonempty and supported by the service. type: string requestedCount: description: >- The number of nodes requested for this instance type. Must be greater than zero. type: integer format: int32 required: - instanceType - requestedCount coreweave.capacity.v1beta1.CapacityAvailabilityResult: description: >- CapacityAvailabilityResult contains availability guidance for one zone, instance type, and capacity plan. type: object properties: zone: description: The evaluated availability zone. type: string score: description: >- Relative availability for the requested node count. Higher scores indicate more favorable capacity. This is a banded score derived from cached capacity, not a calibrated probability or a guarantee that provisioning will succeed. type: number format: double instanceType: description: The evaluated CoreWeave instance type. type: string capacityPlan: description: >- The evaluated capacity plan. Every result echoes the plan you requested, so this is always `CAPACITY_PLAN_SPOT`. The underlying enum also declares `CAPACITY_PLAN_UNSPECIFIED`, its zero value, which does not appear in results. type: string format: enum enum: - CAPACITY_PLAN_SPOT google.protobuf.Any: description: >- Contains an arbitrary serialized message along with a @type that describes the type of the serialized message. type: object properties: '@type': description: The type of the serialized message. type: string additionalProperties: true securitySchemes: bearerAuth: type: http description: Use a CoreWeave API access token for your organization. scheme: bearer ```` ## Related topics - [Capacity Finder API](/platform/capacity-plans/capacity-finder-api.md)