Quickstart Guide

Get up and running with the Acquisition Atlas API in under 5 minutes.

1. Get your API key

1. Sign in to app.acqatlas.com
2. Navigate to Settings > API
3. Click Create API Key
4. Copy the key — it's only shown once

Your key looks like: ak_live_a1b2c3d4e5f6...

2. Make your first request

export ACQATLAS_API_KEY="ak_live_your_key_here"

curl -s -H "X-API-Key: $ACQATLAS_API_KEY" \
  "https://api.acqatlas.com/v1/filings?limit=3" | python3 -m json.tool

3. Filter by county

curl -s -H "X-API-Key: $ACQATLAS_API_KEY" \
  "https://api.acqatlas.com/v1/filings?county=Miami-Dade&min_amount=5000&limit=10"

4. Get a single filing's details

curl -s -H "X-API-Key: $ACQATLAS_API_KEY" \
  "https://api.acqatlas.com/v1/filings/12345"

5. Search by keyword

curl -s -H "X-API-Key: $ACQATLAS_API_KEY" \
  "https://api.acqatlas.com/v1/filings/search?q=trust&county=Broward"

Language examples

Python

import requests

API_KEY = "ak_live_your_key_here"
BASE_URL = "https://api.acqatlas.com/v1"

response = requests.get(
    f"{BASE_URL}/filings",
    headers={"X-API-Key": API_KEY},
    params={"county": "Miami-Dade", "limit": 20, "min_amount": 5000}
)

data = response.json()
for filing in data["data"]:
    print(f"{filing['owner']} — ${filing['currentAmount']:,.2f} — {filing['propertyAddress']}")

JavaScript / Node.js

const API_KEY = "ak_live_your_key_here";

const res = await fetch(
  "https://api.acqatlas.com/v1/filings?county=Miami-Dade&limit=20",
  { headers: { "X-API-Key": API_KEY } }
);

const { data, pagination } = await res.json();
console.log(`Found ${pagination.total} filings`);
data.forEach(filing => {
  console.log(`${filing.owner} — $${filing.currentAmount} — ${filing.propertyAddress}`);
});

Next steps

• Response format — Understand the standard response envelope
• List filings — Full filtering reference
• Rate limits — Understand your usage limits