Environments & Headers

AddressValid provides isolated environment execution modes to support testing and staging deployments without modifying target URLs:

• Live Environment: Access with live keys (sk_live_...). Interacts directly with spatial PostgreSQL clusters, PostGIS, and OpenSearch.
• Sandbox Environment: Pass header x-environment: sandbox or use a sandbox key (sk_test_...). Uses ultra-fast memory stubs and returns mock data instantly.

1
2
3
4
GET /v1/address/autocomplete?query=Allen+Avenue HTTP/1.1
Host: api.addressvalid.io
Authorization: Bearer sk_live_key
x-environment: sandbox