Skip to main content

Documentation Index

Fetch the complete documentation index at: https://enrich-docs.dealmachine.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

The DealMachine Property Enrichment API uses API keys for authentication. All requests must include your API key in the X-API-Key header.

​
Getting Your API Key

API keys are managed through your DealMachine dashboard. Only organization administrators can create and manage API keys.
1

Navigate to API Settings

Log in to your DealMachine account and go to Settings > API Keys
2

Create a New Key

Click Create API Key and provide a descriptive name (e.g., “Salesforce Integration”)
3

Copy Your Key

Your API key will be displayed once. Copy it and store it securely - it cannot be retrieved later.
Keep your API key secret! Never expose your API key in client-side code, public repositories, or share it with unauthorized parties.

​
Using Your API Key

Include your API key in the X-API-Key header with every request: 
curl -X POST https://next.v3.dealmachine.com/api/property/lookup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: dm_live_your_api_key_here" \
  -d '{"street": "123 Main St", "city": "Austin", "state": "TX", "zip": "78701"}'

​
API Key Format

DealMachine API keys follow the format: 
dm_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Prefix: dm_live_ (12 characters)
  • Random suffix: 32 hexadecimal characters

​
Key Management

​
One Active Key Per Organization

Your organization can have only one active API key at a time. Creating a new key will automatically revoke any existing active keys.

​
Regenerating Keys

If you suspect your API key has been compromised, regenerate it immediately through the dashboard. The old key will be revoked instantly.

​
Revoking Keys

You can revoke an API key at any time through the dashboard. Revoked keys cannot be reactivated.

​
Error Responses

Status CodeErrorDescription
401UnauthorizedMissing or invalid X-API-Key header
401UnauthorizedAPI key has been revoked
403Subscription RequiredNo active subscription found
403Subscription RequiredSubscription is not active
429Too Many RequestsMonthly request limit exceeded
When you receive a 429 response, check the X-RateLimit-Reset header for the date your limit resets.