> ## Documentation Index > Fetch the complete documentation index at: https://docs.server.express/llms.txt > Use this file to discover all available pages before exploring further. # Order one or more cloud servers > Reserves up to 10 VDS on one plan: a PENDING service per server and a single UNPAID invoice covering the lot. Nothing is cloned on Proxmox until that invoice settles. Prices, term discounts and add-ons are re-derived server-side from ids; the caller never sends an amount. Requires a complete billing address (428 otherwise) and refuses sanctioned countries (403). When `quantity` exceeds the number of `hostnames`, extra names are generated from the first one (`web.example.com` → `web-2.example.com`). Hostnames must be unique, letters/digits/hyphens, up to 63 characters per label and 253 overall. ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/client/cloud/buy openapi: 3.1.0 info: title: Server.Express API version: 1.0.0 description: >- The customer-facing Server.Express API: auth, billing, tickets, cloud and dedicated servers, hosting, reselling and account management. Every response uses the `{ success, data | error }` envelope. contact: name: Server.Express url: https://server.express servers: - url: https://my.server.express/api description: Production security: - bearerAuth: [] - apiToken: [] tags: - name: API Tokens - name: Account - name: Auth - name: Cloud - name: Coupons - name: Credits - name: Dashboard - name: Dedicated - name: Health - name: Hosting - name: Integrations - name: Invoices - name: Livechat - name: Notifications - name: Passkeys - name: Payments - name: Products - name: Public - name: Public Invoices - name: Public Tools - name: Reseller - name: SSH Keys - name: Services - name: Tasks - name: Teams - name: Tickets - name: Web Hosting - name: Webhooks paths: /v1/client/cloud/buy: post: tags: - Cloud summary: Order one or more cloud servers description: >- Reserves up to 10 VDS on one plan: a PENDING service per server and a single UNPAID invoice covering the lot. Nothing is cloned on Proxmox until that invoice settles. Prices, term discounts and add-ons are re-derived server-side from ids; the caller never sends an amount. Requires a complete billing address (428 otherwise) and refuses sanctioned countries (403). When `quantity` exceeds the number of `hostnames`, extra names are generated from the first one (`web.example.com` → `web-2.example.com`). Hostnames must be unique, letters/digits/hyphens, up to 63 characters per label and 253 overall. operationId: publicClientBuyCloud requestBody: required: true content: application/json: schema: type: object required: - planId properties: planId: type: string description: >- Cloud plan slug (the `id` from GET /v1/client/cloud/marketplace). hostname: type: string description: >- Hostname for a single server. Required unless `hostnames` is given. hostnames: type: array items: type: string description: >- One hostname per server. Wins over `hostname` when non-empty. quantity: type: integer minimum: 1 maximum: 10 description: >- Number of servers. Defaults to the number of hostnames, or 1. location: type: string description: >- CloudLocation slug. Uncertain — when omitted, the order service picks a default location. nodeGroupId: type: string description: Pin the order to one group of hardware within the location. os: type: string description: OS template slug. An unknown slug is rejected. app: type: string description: >- One-click app slug. Needs a Docker-capable template to be configured. appInputs: type: object additionalProperties: true description: Values for the app's env schema, validated against it. billingCycle: type: string enum: - monthly - quarterly - semi-annually - annually - biennially - triennially default: monthly description: >- Term to buy on. Longer terms are discounted (5%–30%). Any other value is rejected. addonIds: type: array items: type: string description: >- AddonProduct ids billed alongside every server. Each must be sold in the customer's billing currency. couponCode: type: string description: Optional discount code, validated server-side. responses: '200': description: Order placed; pay the invoice to provision. content: application/json: schema: type: object required: - success - data properties: success: type: boolean const: true data: allOf: - $ref: '#/components/schemas/PublicClientOrderResult' - type: object required: - serviceIds properties: serviceIds: type: array items: type: string format: uuid description: >- One per server, in hostname order. `serviceId` is the first of them. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '428': description: The account has no complete billing address yet. content: application/json: schema: $ref: '#/components/schemas/PublicClientBillingDetailsRequired' '500': $ref: '#/components/responses/ServerError' security: - bearerAuth: [] components: schemas: PublicClientOrderResult: type: object required: - serviceId - invoiceId - invoiceNumber - total - currency properties: serviceId: type: string format: uuid invoiceId: type: string format: uuid invoiceNumber: type: string total: type: integer description: Invoice total including tax, minor units. currency: type: string PublicClientBillingDetailsRequired: type: object description: >- 428 Precondition Required — add the listed billing fields before ordering or paying. required: - success - error - data properties: success: type: boolean const: false error: type: string data: type: object required: - billingDetailsRequired - missing properties: billingDetailsRequired: type: boolean const: true missing: type: array items: type: string enum: - addressLine1 - city - postcode - country - companyName ErrorResponse: type: object required: - success - error properties: success: type: boolean const: false error: type: string description: Human-readable error message. additionalProperties: true responses: BadRequest: description: Validation failed or the request is malformed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Missing, invalid or expired credentials. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: >- Authenticated but not allowed (missing scope, not an admin, or not your resource). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: The resource doesn't exist or isn't visible to you. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Conflict: description: The request conflicts with the resource's current state. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ServerError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Session access token (JWT) from POST /v1/auth/login or /v1/auth/refresh. A session satisfies every API scope. apiToken: type: http scheme: bearer bearerFormat: se_live__ description: >- Personal API token created under Settings → API tokens. Only routes guarded by verifyApiAuth accept it, and the token must carry the scope named in the operation's x-required-scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.