AegisGov Truth-Aligned Permitting

GET/api/v1/parcels/:parcelId

Parcel Lookup

Retrieve zoning classification, buildability status, and basic constraints for a specific parcel.

Parameters

parcelIdstringrequired

Official parcel identifier (e.g., ZG-1234-5678)

cantonstringrequired

Two-letter canton code (e.g., ZG, ZH, BS)

Example Response

{
  "parcel_id": "ZG-1234-5678",
  "canton": "ZG",
  "municipality": "Zug",
  "zoning_classification": "W2",
  "buildability_status": "permitted",
  "max_height_meters": 8.5,
  "building_coverage_percent": 35,
  "setback_requirements": {
    "front": 5,
    "side": 3,
    "rear": 5
  },
  "restrictions": [
    "Residential only",
    "Max 2 dwelling units"
  ],
  "confidence_score": 0.96
}

Code Example

const response = await fetch(
  'https://api.aegisgov.ch/v1/parcels/ZG-1234-5678?canton=ZG',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

const data = await response.json();
console.log(data);

Authentication

All API requests require authentication using Bearer tokens. Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get your API key from the enterprise dashboard after signing up.

Rate Limits

Standard

100

requests / hour

Professional

1,000

requests / hour

Enterprise

Custom

Dedicated resources

Error Codes

400Bad Request - Invalid parameters

401Unauthorized - Invalid API key

404Not Found - Parcel not in database

429Too Many Requests - Rate limit exceeded

500Internal Server Error - Contact support