Authentication & API Keys

AddressValid APIs require authentication on every endpoint via one of two supported header formats:

1. Bearer Authorization Header (Recommended):

HTTP
1
Authorization: Bearer sk_live_your_key

1. Custom API Key Header:

HTTP
1
x-api-key: sk_live_your_key

• Live Key: Starts with sk_live_. Performs real-time spatial calculations and database queries.
• Sandbox Key: Starts with sk_test_. Automatically triggers sandbox response mode without consuming API credits.

Security Note: Never expose secret keys (sk_...) in public client-side applications (mobile binaries or browser JS). Use restricted public keys (pk_live_...) or proxy client requests through your backend server.