> ## Documentation Index > Fetch the complete documentation index at: https://www.vobiz.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List countries in stock > Returns the countries where you can buy messaging numbers, with the number types and capabilities in stock in each. ## OpenAPI ````yaml openapi-sms.yaml GET /numbers/countries openapi: 3.0.3 info: title: Vobiz Messaging API description: > Send and receive SMS, MMS and RCS messages, buy messaging numbers, register for US 10DLC and toll-free, run broadcasts, manage conversations, opt-outs and webhooks. **Base URL:** `https://api.vobiz.ai/api/v1/sms` **Authentication:** every request needs the `X-Auth-ID` and `X-Auth-Token` headers. The account is taken from your credentials; you never put an account ID in a path or body. Field names in this API are camelCase. version: '1.0' contact: email: support@vobiz.ai url: https://vobiz.ai servers: - url: https://api.vobiz.ai/api/v1/sms description: Production security: - AuthID: [] AuthToken: [] tags: - name: Messages description: Send messages and inspect their delivery state. - name: Numbers description: >- Messaging-capable numbers on your account, inventory search, purchase and release. - name: Coverage description: Where you can send, per country. - name: Conversations description: Two-way threads between one of your numbers and a contact. - name: Opt-outs description: Numbers that must not receive messages on a channel. - name: Webhooks description: Subscriptions that deliver message and broadcast events to your server. - name: Broadcasts description: Bulk sends from an uploaded recipient list. - name: RCS Senders description: RCS sender (agent) identities and their message templates. - name: 10DLC Brands description: US 10DLC brand registration. - name: 10DLC Campaigns description: US 10DLC campaigns, toll-free verification and supporting documents. paths: /numbers/countries: get: tags: - Numbers summary: List countries in stock description: >- Returns the countries where you can buy messaging numbers, with the number types and capabilities in stock in each. The list is a snapshot that refreshes in the background: while `ready` is `false`, `countries` is empty and you retry shortly. India is not listed, because traffic to Indian recipients is sent from DLT-registered sender IDs. Pass a returned `country` to `GET /numbers/available` to see individual numbers. operationId: list-countries responses: '200': description: Countries with stock. content: application/json: schema: $ref: '#/components/schemas/NumberCountries' examples: ready: summary: Snapshot ready value: countries: - country: CA name: Canada types: - local capabilities: - SMS - MMS - VOICE - country: GB name: United Kingdom types: - local capabilities: - SMS - country: US name: United States types: - local - tollfree capabilities: - SMS - MMS - VOICE updatedAt: '2026-10-18T03:19:11Z' ready: true warming: summary: Snapshot still building value: countries: [] updatedAt: null ready: false '401': $ref: '#/components/responses/Unauthorized' x-codeSamples: - lang: typescript label: Node SDK source: > import { VobizClient } from "@vobiz/sdk"; const client = new VobizClient({ apiKey: "MA_XXXXXXXX", authToken: "YOUR_AUTH_TOKEN" }); await client.sms.numbers.listCountries() - lang: python label: Python SDK source: | from vobiz import Vobiz client = Vobiz(api_key="MA_XXXXXXXX", auth_token="YOUR_AUTH_TOKEN") client.sms.numbers.list_countries() - lang: go label: Go SDK source: | import ( "context" vobiz "github.com/vobiz-ai/Vobiz-Go-SDK" "github.com/vobiz-ai/Vobiz-Go-SDK/client" "github.com/vobiz-ai/Vobiz-Go-SDK/option" "github.com/vobiz-ai/Vobiz-Go-SDK/sms" ) c := client.NewClient( option.WithAPIKey("MA_XXXXXXXX"), option.WithAuthToken("YOUR_AUTH_TOKEN"), ) c.Sms.Numbers.ListCountries( context.TODO(), ) - lang: java label: Java SDK source: | import com.vobiz.api.VobizApiClient; VobizApiClient client = VobizApiClient .builder() .apiKey("MA_XXXXXXXX") .authToken("YOUR_AUTH_TOKEN") .build(); client.sms().numbers().listCountries(); - lang: ruby label: Ruby SDK source: > require 'vobiz' client = Vobiz::Client.new(api_key: 'MA_XXXXXXXX', auth_token: 'YOUR_AUTH_TOKEN') client.sms.numbers.list_countries - lang: csharp label: C# SDK source: | using Vobiz; using Vobiz.Sms; var client = new VobizApiClient("YOUR_AUTH_TOKEN", "MA_XXXXXXXX"); await client.Sms.Numbers.ListCountriesAsync(); - lang: php label: PHP SDK source: > sms->numbers->listCountries(); components: schemas: NumberCountries: type: object properties: countries: type: array items: $ref: '#/components/schemas/NumberCountry' description: Countries with numbers in stock. Empty while `ready` is `false`. updatedAt: type: string format: date-time nullable: true description: >- When the stock snapshot was last refreshed (ISO 8601). `null` until the first snapshot is built. example: '2026-10-18T03:19:11Z' ready: type: boolean description: >- `true` once the stock snapshot has been built. While `false`, `countries` is empty and `updatedAt` is `null`; retry after a few seconds. description: >- Countries where you can buy messaging numbers, from a snapshot of the inventory. NumberCountry: type: object description: A country with messaging numbers in stock. properties: country: type: string description: >- ISO 3166-1 alpha-2 code of the country. Pass it as `country` to `GET /numbers/available`. example: US name: type: string example: United States description: English name of the country, for example `United States`. types: type: array description: >- Number types in stock: `local`, `mobile`, `tollfree` or `shortcode`, or another lower-case inventory type. items: type: string example: - local - tollfree capabilities: type: array items: type: string example: - SMS - MMS - VOICE description: >- Upper-case capabilities offered by numbers in stock in the country, for example `SMS`, `MMS` and `VOICE`. Not every number has every capability; filter with `capabilities` on `GET /numbers/available`. Error: type: object description: >- The body of every error response: a flat object with one `error` string that explains what went wrong. Use the HTTP status code to decide how to handle the error, and log `error` for diagnosis. required: - error properties: error: type: string example: 'recipient has opted out: +14155550123' description: >- Human-readable explanation of the error, for example `phoneNumber is required` or `recipient has opted out: +14155550123`. Branch on the HTTP status code rather than on this text. responses: Unauthorized: description: Missing or invalid `X-Auth-ID` / `X-Auth-Token`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: missing or invalid credentials securitySchemes: AuthID: type: apiKey in: header name: X-Auth-ID description: Your Vobiz account Auth ID (`MA_XXXXXXXX`). AuthToken: type: apiKey in: header name: X-Auth-Token description: Your Vobiz account Auth Token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.