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:
| 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.
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"
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.