API reference
Sovereignty finder
Last updated
Purpose
Given a set of data-residency and regulatory constraints, returns the set of Azure regions that satisfy them, with provenance for each constraint (cloud type, geography, certification, paired region). Optionally returns a starter Bicep snippet that enforces region restriction.
Base URL
https://api.farshorelabs.com/sovereignty-finder/v1
Service ID for API key scoping: sovereignty-finder.
POST /find-regions
POST /v1/find-regions
Authorization: Bearer fsl_live_...
Content-Type: application/json
{
"residency": {
"allowedGeographies": ["europe"],
"disallowedCountries": ["RU", "BY"]
},
"compliance": {
"required": ["iso-27001", "iso-27018", "c5"],
"preferred": ["tisax"]
},
"topology": {
"pairedRegionRequired": true,
"availabilityZones": "required"
},
"cloud": "azure-public"
}Response (200):
{
"matched": [
{
"region": "westeurope",
"geography": "europe",
"country": "NL",
"pairedRegion": "northeurope",
"availabilityZones": 3,
"certifications": ["iso-27001", "iso-27018", "c5", "tisax"],
"score": 1.0
},
{
"region": "northeurope",
"geography": "europe",
"country": "IE",
"pairedRegion": "westeurope",
"availabilityZones": 3,
"certifications": ["iso-27001", "iso-27018", "c5"],
"score": 0.92
}
],
"rejected": [
{
"region": "germanywestcentral",
"reason": "missing-certification",
"missing": ["tisax"]
}
],
"asOf": "2026-05-22T03:00:00Z"
}POST /bicep
Generates a Bicep parameter file and policy assignment that restricts deployments to a given allow-list of regions. Useful to lock down a subscription or management group to the regions returned by /find-regions.
GET /frameworks
Lists the compliance frameworks the service recognises along with their canonical slugs (used in request payloads).