Skip to main content
POST
Get capacity availability
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.
The Capacity Finder API is in beta. Its request and response behavior can change, including in ways that are not backward compatible.
For request guidance and result interpretation, see the Capacity Finder API overview. Authenticate with a CoreWeave API access token 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 and go up to 0.95. Higher scores indicate more favorable availability. They do not reserve Nodes or guarantee provisioning. Results include only Zones with available capacity for the instance type.

인증

Authorization
string
header
필수

Use a CoreWeave API access token for your organization.

본문

application/json

GetCapacityAvailabilityRequest defines the capacity options to evaluate.

capacityPlans
enum<string>[]
필수

Exactly one capacity plan is required. Send CAPACITY_PLAN_SPOT, the only supported plan.

사용 가능한 옵션:
CAPACITY_PLAN_SPOT
selections
object[]
필수

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.

zones
string[]

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.

응답

OK

GetCapacityAvailabilityResponse contains ranked availability results.

results
object[]

Ordered by descending score, then by instance type and zone. Each result represents one zone, instance type, and capacity plan. A selection without positive cached capacity contributes no results. An empty result is successful. Do not expect a result for every requested zone and instance type.

마지막 수정일 2026년 9월 30일