Retrieve geographic permissions

GET

https://{your_space_name}.signalwire.com/api/space/geographic_permissions

Permissions

Authenticate with a Personal access token whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder’s role in the space is the whole authorization decision.

Returns the countries the space has selected for international traffic, together with the countries it may select. The selection is read from the billing service, so the response is `502` when that service is unavailable. #### Permissions Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

Authentication

AuthorizationBasic

Personal access token authentication for space-wide administration.

Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project’s: it is created from your user menu in the Dashboard, is prefixed pat_, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space.

Example:

Authorization: Basic base64(:pat_...)

Personal access token authentication for space-wide administration. Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project's: it is created from your user menu in the Dashboard, is prefixed `pat_`, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space. Example: ``` Authorization: Basic base64(:pat_...) ```

Response

The request has succeeded.

typeenum

The object type. Always geographic_permission.

countrieslist of strings

The selected ISO 3166-1 alpha-2 country codes.

supported_countrieslist of strings

The ISO 3166-1 alpha-2 country codes that may be selected.

Errors

401

Unauthorized Error

500

Internal Server Error

502

Bad Gateway Error