PCI Vault Logo
Region Preference

PCI Vault runs in several regions. You can choose the region your account works from by setting the preferred_region preference. Once it is set:

  • Proxy requests originate from the preferred region.
  • The dashboard calls the API URLs of the preferred region.

Available Regions

Region Location API URL
eu-west-1 Europe https://api.pcivault.io
ap-southeast-1 Asia Pacific https://api-ap.pcivault.io
sa-south-1 South America https://api-sa.pcivault.io
ca-central-1 Canada https://api-ca.pcivault.io
us-east-1 United States https://api-us.pcivault.io

eu-west-1 (Europe) is the default region.

Setting Your Preferred Region

Send a POST request to the preferences endpoint, with preferred_region as the key and one of the regions above as the value.

curl -X POST https://api.pcivault.io/v1/preferences \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "preferred_region",
    "value": "us-east-1"
  }'

The response confirms the stored preference:

{
  "key": "preferred_region",
  "value": "us-east-1"
}

To check your current preference, send a GET request to the preferences endpoint with the key:

curl https://api.pcivault.io/v1/preferences?key=preferred_region \
  -u "username:password"

To go back to the default region, delete the preference:

curl -X DELETE https://api.pcivault.io/v1/preferences?key=preferred_region \
  -u "username:password"

Region-Specific API URLs

You can also call a region's API URL directly, such as https://api-us.pcivault.io. Proxy requests made through a region-specific URL automatically originate from that region, whether or not a preference is set.

Note: Region-specific API URLs are only available to accounts on the Business or Enterprise packages. On other packages, you can still make proxy requests from any region by setting the region parameter on the proxy endpoints.

However, the dashboard only uses the preferred_region preference to decide which region to load. If you use region-specific URLs without setting the preference, the dashboard loads the default region (eu-west-1). Set the preference if you want the dashboard to use the same region as your API calls.