> ## Documentation Index > Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt > Use this file to discover all available pages before exploring further. # List flavors > List all available instance flavors. The catalog is small and comes back in one shot — this endpoint is not paginated. ## OpenAPI ````yaml /api-reference/specs/compute.yaml get /v1/flavors openapi: 3.0.3 info: title: Basaltic Compute API version: 1.0.0 description: | Virtual machine instances, and the images, flavors, SSH keypairs and instance pools they are built from. Covers the whole instance lifecycle: start, stop, reboot, resize and reinstall. contact: name: Basaltic Support email: ping@basaltic.sh license: name: Proprietary url: https://basaltic.sh/terms servers: - url: https://compute.{region}.basaltic.sh description: Regional API endpoint variables: region: default: sa-saopaulo-1 description: Region code security: - SignatureAuth: [] paths: /v1/flavors: get: tags: - Compute summary: List flavors description: >- List all available instance flavors. The catalog is small and comes back in one shot — this endpoint is not paginated. operationId: listFlavors parameters: - name: family in: query description: >- Filter by product family. Load-balancer and database create flows should list their own family; regular instances use "general". schema: type: string enum: - general - loadbalancer - database example: general responses: '200': description: List of flavors content: application/json: schema: $ref: '#/components/schemas/FlavorListResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' security: - SignatureAuth: [] components: schemas: FlavorListResponse: type: object properties: flavors: type: array items: $ref: '#/components/schemas/Flavor' Flavor: type: object description: >- A compute size (vCPU + RAM). A flavor carries no disk size — the boot disk is a customer volume sized at launch, floored by the image's min_disk_gb. properties: id: type: string format: uuid readOnly: true example: 550e8400-e29b-41d4-a716-446655440000 crn: type: string readOnly: true description: Cloud Resource Name example: >- crn:compute:sa-saopaulo-1::flavor/550e8400-e29b-41d4-a716-446655440000 region_id: type: string readOnly: true example: sa-saopaulo-1 name: type: string example: m1.medium description: type: string example: Medium instance with 2 vCPUs and 4GB RAM vcpus: type: integer description: Number of virtual CPUs example: 2 ram_mb: type: integer description: RAM in MB example: 4096 class: type: string description: >- Host-pool routing. "shared" oversubscribes CPU for higher density; "dedicated" pins each vCPU 1:1 to a physical core. enum: - shared - dedicated example: shared family: type: string description: >- Which product can book the flavor. "general" flavors are for regular instances and instance pools; "loadbalancer" and "database" flavors are reserved for the managed products (their nodes are platform- operated and priced accordingly) and cannot be used for regular instances. enum: - general - loadbalancer - database example: general status: type: string enum: - active - disabled example: active created_at: type: string format: date-time readOnly: true updated_at: type: string format: date-time readOnly: true Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: Error code identifying the type of error example: INVALID_INPUT message: type: string description: Human-readable error message example: Invalid request parameters request_id: type: string format: uuid description: Request ID for debugging example: 550e8400-e29b-41d4-a716-446655440000 responses: Unauthorized: description: Authentication required or token invalid content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: Authentication required request_id: 550e8400-e29b-41d4-a716-446655440000 Forbidden: description: Insufficient permissions content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: ACCESS_DENIED message: You don't have permission to perform this action request_id: 550e8400-e29b-41d4-a716-446655440000 InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: An internal error occurred request_id: 550e8400-e29b-41d4-a716-446655440000 securitySchemes: SignatureAuth: type: apiKey in: header name: Authorization description: > Request signing with an access key issued to a service account. An HMAC-SHA256 over a canonical form of the request, close to AWS SigV4. The `basaltic` CLI signs for you. Send `Authorization`, `X-Date` (UTC, `YYYYMMDDTHHMMSSZ`) and `X-Nonce` (random per request); add `X-Content-Sha256` to bind a body, and `X-Amz-Security-Token` when using temporary credentials. ``` Authorization: BASALTIC-HMAC-SHA256 Credential=///basaltic/basaltic_request, SignedHeaders=host;x-date;x-nonce, Signature= ``` `` is the region code you are calling, or `global` for the global services. A signature is valid for 5 minutes from `X-Date`, and mutating requests are replay-guarded on the nonce. **Full signing procedure, including a working implementation:** https://docs.basaltic.sh/authentication ## Rate limits There is no global request budget. A limit applies only where an operation documents a `429`, and that operation says what it counts. Those responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` and, on a `429`, `Retry-After` — read them rather than hard-coding a number. Retrying before `Retry-After` is refused and extends the window. Everything else is bounded by quota, not by request rate. ````