---
title: "Resolve address cascade steps for a number order"
method: GET
path: "/v1/numbers/address-options"
---

# Resolve address cascade steps for a number order

`GET /v1/numbers/address-options`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/numbers/address-options`
- Auth: HTTP bearer

Addresses for ordering a number from a region outside the listing. This walks the carrier's cascading directory: send `psc` and get municipalities, add `obec` and get districts, `cobce` returns streets, and `ulice` returns building numbers. Once `cp` is picked, a readable address arrives in the `recap` field. Don't invent codes - only the ones returned here are valid. A faster path that skips the cascade is `query`, see the callout below.

## Query parameters

- `query` string
- `psc` string
- `obec` string
- `cobce` string
- `ulice` string
- `cp` string

## Response `200`

Address cascade options

- object
  - `obce` object[], required
    - `value` string, required
    - `label` string, required
  - `casti` object[], required
    - `value` string, required
    - `label` string, required
  - `ulice` object[], required
    - `value` string, required
    - `label` string, required
  - `cp` object[], required
    - `value` string, required
    - `label` string, required
  - `recap` string, nullable, required
  - `selection` object
    - `psc` string, required
    - `obec` string, required
    - `cobce` string, required
    - `ulice` string, required
    - `cp` string, required
  - `ambiguousLevel` 'obec' | 'cobce' | 'ulice' | 'cp'
  - `message` string

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).
- `502`: Error codes: provisioning_failed (service).
- `503`: Error codes: orders_disabled (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)