Skip to main content
Get your first API response in under 5 minutes. Choose your path:

CLI (Fastest)

One command to authenticate, instant access

API Key

Create a key in the dashboard, call the API directly

Option 1: DealMachine CLI

Step 1: Login

npx @dealmachine/cli login
Your browser opens. Sign in and approve the device. That’s it.

Step 2: Check Your Account

dealmachine account
Account
----------------------------------------
Organization:  My Company
Org ID:        1
Created:       Jan 1, 2024
Auth Type:     api_key

Step 3: Use the API Key Programmatically

The CLI stores your API key at ~/.dealmachine/config.json. Use it in your code:
import { readFileSync } from 'fs';
import { join } from 'path';
import { homedir } from 'os';

const config = JSON.parse(readFileSync(join(homedir(), '.dealmachine', 'config.json'), 'utf-8'));

const response = await fetch('https://api.v2.dealmachine.com/v1/account', {
  headers: { Authorization: `Bearer ${config.apiKey}` },
});

const { data } = await response.json();
console.log(data.organization.name);

Option 2: API Key

Step 1: Create an API Key

  1. Go to Developer Settings
  2. Click Create API Key
  3. Copy the key (starts with dm_sk_live_)
Copy the key now. It won’t be shown again.

Step 2: Make Your First Request

curl https://api.v2.dealmachine.com/v1/account \
  -H "Authorization: Bearer dm_sk_live_YOUR_KEY_HERE"

Step 3: See the Response

{
  "data": {
    "organization": {
      "id": 1,
      "name": "My Company",
      "createdAt": "2024-01-01T00:00:00.000Z"
    },
    "user": {
      "id": null,
      "authType": "api_key"
    },
    "plan": {
      "name": "Starter",
      "enrichment_credit_cap": 10000,
      "is_paid": true,
      "billing_cycle_start": "2024-01-01T00:00:00.000Z",
      "billing_cycle_end": "2024-02-01T00:00:00.000Z"
    }
  }
}
You’re authenticated and ready to go.

What’s Next

API Reference

Browse all available endpoints

CLI Commands

Full CLI command reference

Authentication

Deep dive into auth options

Error Handling

Understand error responses