Authentication

All data endpoints require an API key passed via the X-API-Key header.

API Key Format

API keys start with the prefix pda_ followed by a 64-character hex string:

pda_a1b2c3d4e5f6...

Using Your Key

Include the key in every request as an HTTP header:

curl -H "X-API-Key: pda_your_key_here" \
  "https://api.propertypulse.dev/v1/properties/lookup?street=123+Main+St&state=OR"

Key Security

• Your full API key is shown only once when created. We store a SHA-256 hash and cannot retrieve it.
• Treat your API key like a password. Do not expose it in client-side code or commit it to version control.
• If a key is compromised, revoke it immediately in your dashboard and create a new one.
• You can create multiple keys (e.g., separate keys for production and development).

Email Confirmation Required

API keys only work after you confirm your email address. If you receive a 403 response, check that your email has been confirmed in your dashboard settings.