List accounts

curl --request GET \
  --url https://api.letterdrop.com/api/v2/accounts \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.letterdrop.com/api/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "accounts": [
      {
        "account_id": "domain:acme.com",
        "company_name": "Acme",
        "company_domain": "acme.com",
        "company_size": "1001-5000",
        "company_industry": "Software Development",
        "company_hq_country": "US",
        "company_hq_location": "San Francisco, California",
        "company_description": "Acme makes workflow software for finance teams.",
        "company_logo_url": "https://cdn.letterdrop.co/logos/acme.png",
        "account_competitors": "HubSpot, Salesforce",
        "account_competitor_cycle_stage": "Early Stage",
        "account_competitor_cycle_reason": "Three decision makers engaged HubSpot sales reps in the last 30 days; no deal activity yet.",
        "account_priority": "High",
        "account_icp_fit": true,
        "account_icp_fit_reason": "Matches the industries and company sizes of your closed-won customers.",
        "account_confirmed_competitor": "HubSpot - Source: https://jobs.example.com/acme/marketing-ops-manager",
        "account_confirmed_project": "",
        "account_estimated_renewal_date": "2027-03-01",
        "account_optimal_outreach_date": "",
        "account_evaluating_vendors_confirmed": false,
        "account_signal_freshness": "Recent",
        "first_signal_date": "2026-10-02",
        "first_signal_date_approximate": false,
        "latest_signal_date": "2026-10-28",
        "latest_signal_summary": "Jane Doe engaged with a Vice President of Sales at HubSpot.",
        "crm_account_url": "https://app.hubspot.com/contacts/12345678/company/17598685516",
        "crm_account_owner_name": "Alex Owner",
        "crm_account_owner_email": "alex@example.com",
        "crm_is_customer": false,
        "crm_has_open_opp": true,
        "crm_opp_count": 1,
        "crm_latest_opp_id": "64931875364",
        "crm_latest_opp_stage": "S1: Discover (SAO)",
        "crm_latest_opp_amount": 24000,
        "crm_latest_opp_pipeline": "New Business",
        "crm_latest_opp_created_date": "2026-10-29",
        "crm_latest_opp_close_date": "2026-12-15",
        "crm_latest_opp_owner_name": "Alex Owner",
        "crm_latest_opp_owner_email": "alex@example.com",
        "crm_latest_opp_is_renewal": false,
        "crm_custom_fields": {
          "hubspot:company:Tier": [
            "A"
          ]
        },
        "outreach_status": "reached_out_after_signal",
        "outreach_started": true,
        "outreach_any_replied": true,
        "outreach_attribution": "direct_reply",
        "outreach_attribution_reason": "The meeting was booked after Jane replied to the Oct 24 outreach.",
        "outreach_summary": "First touch four days after the signal; a meeting was booked a week later.",
        "outreach_before_signal": false,
        "outreach_lead_source": "outbound",
        "outreach_last_date": "2026-10-24",
        "outreach_last_before_signal_date": "",
        "outreach_first_after_signal_date": "2026-10-24",
        "outreach_meeting_booked_date": "2026-10-30",
        "account_contact_count": 3,
        "contacts": [
          {
            "contact_name": "Jane Doe",
            "contact_job_title": "VP Marketing",
            "contact_linkedin_url": "https://example.com/in/jane-doe",
            "contact_type": "Engaged Contact",
            "contact_role": "champion",
            "contact_bucket": "strong",
            "contact_buying_committee_role": "business_evaluator",
            "contact_first_signal_date": "2026-10-02",
            "contact_latest_signal_date": "2026-10-28",
            "signal_freshness": "Recent",
            "recommended_channels": "Email + Call",
            "recommended_email": true,
            "recommended_linkedin": false,
            "recommended_call": true,
            "outreach_contacted": true,
            "outreach_replied": false,
            "outreach_contacted_by_name": "Alex Owner",
            "outreach_contacted_by_email": "alex@example.com",
            "signals": [
              {
                "signal_id": "6aa5558899db31a0da3c9465",
                "signal_summary": "Engaged with a Vice President of Sales at HubSpot",
                "signal_post_url": "https://example.com/posts/7392000000000000000",
                "signal_freshness": "Recent",
                "signal_date": "2026-10-28",
                "signal_collected_date": "2026-10-28",
                "competitor_name": "HubSpot",
                "competitor_rep_title": "Vice President of Sales"
              },
              {
                "signal_id": "6aa5558899db31a0da3c9411",
                "signal_summary": "Engaged with an Account Executive at HubSpot",
                "signal_post_url": "",
                "signal_freshness": "Recent",
                "signal_date": "2026-10-02",
                "signal_collected_date": "2026-10-02",
                "competitor_name": "HubSpot",
                "competitor_rep_title": "Account Executive"
              }
            ]
          }
        ]
      }
    ]
  },
  "pagination": {
    "total": 541,
    "has_more": true,
    "next_cursor": "eyJ2IjoyLC4uLn0.c2lnbmF0dXJl"
  },
  "meta": {
    "api_version": "2",
    "data_as_of": "2026-11-02T09:36:28.016Z",
    "cache": "miss"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

GET

accounts

List accounts

curl --request GET \
  --url https://api.letterdrop.com/api/v2/accounts \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://api.letterdrop.com/api/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "accounts": [
      {
        "account_id": "domain:acme.com",
        "company_name": "Acme",
        "company_domain": "acme.com",
        "company_size": "1001-5000",
        "company_industry": "Software Development",
        "company_hq_country": "US",
        "company_hq_location": "San Francisco, California",
        "company_description": "Acme makes workflow software for finance teams.",
        "company_logo_url": "https://cdn.letterdrop.co/logos/acme.png",
        "account_competitors": "HubSpot, Salesforce",
        "account_competitor_cycle_stage": "Early Stage",
        "account_competitor_cycle_reason": "Three decision makers engaged HubSpot sales reps in the last 30 days; no deal activity yet.",
        "account_priority": "High",
        "account_icp_fit": true,
        "account_icp_fit_reason": "Matches the industries and company sizes of your closed-won customers.",
        "account_confirmed_competitor": "HubSpot - Source: https://jobs.example.com/acme/marketing-ops-manager",
        "account_confirmed_project": "",
        "account_estimated_renewal_date": "2027-03-01",
        "account_optimal_outreach_date": "",
        "account_evaluating_vendors_confirmed": false,
        "account_signal_freshness": "Recent",
        "first_signal_date": "2026-10-02",
        "first_signal_date_approximate": false,
        "latest_signal_date": "2026-10-28",
        "latest_signal_summary": "Jane Doe engaged with a Vice President of Sales at HubSpot.",
        "crm_account_url": "https://app.hubspot.com/contacts/12345678/company/17598685516",
        "crm_account_owner_name": "Alex Owner",
        "crm_account_owner_email": "alex@example.com",
        "crm_is_customer": false,
        "crm_has_open_opp": true,
        "crm_opp_count": 1,
        "crm_latest_opp_id": "64931875364",
        "crm_latest_opp_stage": "S1: Discover (SAO)",
        "crm_latest_opp_amount": 24000,
        "crm_latest_opp_pipeline": "New Business",
        "crm_latest_opp_created_date": "2026-10-29",
        "crm_latest_opp_close_date": "2026-12-15",
        "crm_latest_opp_owner_name": "Alex Owner",
        "crm_latest_opp_owner_email": "alex@example.com",
        "crm_latest_opp_is_renewal": false,
        "crm_custom_fields": {
          "hubspot:company:Tier": [
            "A"
          ]
        },
        "outreach_status": "reached_out_after_signal",
        "outreach_started": true,
        "outreach_any_replied": true,
        "outreach_attribution": "direct_reply",
        "outreach_attribution_reason": "The meeting was booked after Jane replied to the Oct 24 outreach.",
        "outreach_summary": "First touch four days after the signal; a meeting was booked a week later.",
        "outreach_before_signal": false,
        "outreach_lead_source": "outbound",
        "outreach_last_date": "2026-10-24",
        "outreach_last_before_signal_date": "",
        "outreach_first_after_signal_date": "2026-10-24",
        "outreach_meeting_booked_date": "2026-10-30",
        "account_contact_count": 3,
        "contacts": [
          {
            "contact_name": "Jane Doe",
            "contact_job_title": "VP Marketing",
            "contact_linkedin_url": "https://example.com/in/jane-doe",
            "contact_type": "Engaged Contact",
            "contact_role": "champion",
            "contact_bucket": "strong",
            "contact_buying_committee_role": "business_evaluator",
            "contact_first_signal_date": "2026-10-02",
            "contact_latest_signal_date": "2026-10-28",
            "signal_freshness": "Recent",
            "recommended_channels": "Email + Call",
            "recommended_email": true,
            "recommended_linkedin": false,
            "recommended_call": true,
            "outreach_contacted": true,
            "outreach_replied": false,
            "outreach_contacted_by_name": "Alex Owner",
            "outreach_contacted_by_email": "alex@example.com",
            "signals": [
              {
                "signal_id": "6aa5558899db31a0da3c9465",
                "signal_summary": "Engaged with a Vice President of Sales at HubSpot",
                "signal_post_url": "https://example.com/posts/7392000000000000000",
                "signal_freshness": "Recent",
                "signal_date": "2026-10-28",
                "signal_collected_date": "2026-10-28",
                "competitor_name": "HubSpot",
                "competitor_rep_title": "Vice President of Sales"
              },
              {
                "signal_id": "6aa5558899db31a0da3c9411",
                "signal_summary": "Engaged with an Account Executive at HubSpot",
                "signal_post_url": "",
                "signal_freshness": "Recent",
                "signal_date": "2026-10-02",
                "signal_collected_date": "2026-10-02",
                "competitor_name": "HubSpot",
                "competitor_rep_title": "Account Executive"
              }
            ]
          }
        ]
      }
    ]
  },
  "pagination": {
    "total": 541,
    "has_more": true,
    "next_cursor": "eyJ2IjoyLC4uLn0.c2lnbmF0dXJl"
  },
  "meta": {
    "api_version": "2",
    "data_as_of": "2026-11-02T09:36:28.016Z",
    "cache": "miss"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "<string>",
    "details": [
      {
        "path": "<string>",
        "message": "<string>"
      }
    ]
  }
}

Authorizations

api-key

string

header

required

Scopes

mcp.read

Query Parameters

string

Free-text match on company and contact names.

Maximum string length: 200

account_competitors

string[]

Accounts with signals for any of these competitors (names from GET /fields?object=account).

Required array length: 1 - 200 elements

Required string length: 1 - 500

account_competitor_cycle_stage

enum<string>[]

Inferred competitor buying-cycle stage.

Required array length: 1 - 200 elements

Available options:

Aware of Competitor,

Historical,

Prospecting,

Early Stage,

Late Stage

account_priority

enum<string>[]

Priority.

Required array length: 1 - 200 elements

Available options:

High,

Medium,

Nurture

account_icp_fit

enum<string>

true = only ICP-fit accounts, false = only the rest.

Available options:

true,

false

account_signal_freshness

enum<string>[]

Stale alone = only stale accounts; Recent and Historic together = exclude stale accounts. Other combinations are rejected: Recent and Historic cannot be filtered apart yet.

Required array length: 1 - 200 elements

Available options:

Recent,

Historic,

Stale

latest_signal_within_days

integer

Accounts whose latest signal was within the last N days.

Required range: 1 <= x <= 3650

latest_signal_after

string

Latest signal on or after this date.

latest_signal_before

string

Latest signal on or before this date.

company_size

string[]

Employee bands, e.g. "51-200".

Required array length: 1 - 200 elements

Required string length: 1 - 500

company_hq_country

string[]

Headquarters country, ISO 3166-1 alpha-2 (e.g. "US"); a country name ("United States") is accepted too.

Required array length: 1 - 200 elements

Required string length: 2 - 100

crm_has_account

enum<string>

true = the account was already in your CRM when we found it, false = net new (it was not). An account added to the CRM later can have crm_account_url set and still be net new.

Available options:

true,

false

crm_is_customer

enum<string>

true = your customers only, false = exclude them.

Available options:

true,

false

crm_has_opp

enum<string>

false = accounts with no CRM opportunity. true is the same as listing every crm_latest_opp_stage.

Available options:

true,

false

crm_latest_opp_stage

string[]

Latest opportunity's stage, as your CRM labels it (values from GET /fields?object=account).

Required array length: 1 - 200 elements

Required string length: 1 - 500

crm_latest_opp_owner_email

string<email>[]

Latest opportunity owner's email.

Required array length: 1 - 200 elements

Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

crm_account_owner_name

string[]

CRM account owner's name (values from GET /fields?object=account).

Required array length: 1 - 200 elements

Required string length: 1 - 500

crm_account_owner_email

string<email>[]

CRM account owner's email.

Required array length: 1 - 200 elements

Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

crm_latest_opp_date_within_days

integer

Latest opportunity created or closed within the last N days.

Required range: 1 <= x <= 3650

crm_latest_opp_date_older_than_days

integer

Latest opportunity created or closed more than N days ago.

Required range: 1 <= x <= 3650

crm_latest_opp_date_after

string

Latest opportunity created or closed on or after this date.

crm_latest_opp_date_before

string

Latest opportunity created or closed on or before this date.

outreach_status

enum<string>[]

Where outreach stands. *_after_signal values count only outreach after the first signal.

Required array length: 1 - 200 elements

Available options:

reached_out,

replied,

opportunity_created,

not_reached_out,

reached_out_after_signal,

replied_after_signal,

opportunity_created_after_signal

outreach_attribution

enum<string>[]

Attribution verdict.

Required array length: 1 - 200 elements

Available options:

direct_reply,

driven,

assisted,

detected,

competitive_deal,

not_attributed

preset

enum<string>

A prebuilt view of the table. CRM presets replace crm_latest_opp_stage with their own rule.

Available options:

pilot,

advertising,

capacity_based_outbound,

sell_now,

competitor_aware_tam,

customers_at_risk,

competitive_deals

crm_custom_fields

object

Custom CRM fields, as crm_custom_fields[::]= (e.g. crm_custom_fields[hubspot:company:Tier]=A). Fields AND together; values of one field OR.

Show child attributes

sort

enum<string>

Sort field. Default latest_signal_date.

Available options:

latest_signal_date,

account_priority,

crm_latest_opp_created_date,

crm_latest_opp_close_date

order

enum<string>

Sort order. Default desc.

Available options:

asc,

desc

include

string

Comma-separated: contacts, buying_committee, job_postings, contact_info. Default contacts. buying_committee adds each account's committee (one batched read; /accounts/{account_id}/buying-committee for one account); job_postings adds the per-account job-postings rollup; contact_info adds contact_work_email and contact_phone_number.

max_contacts_per_account

integer

Contacts per account when include has contacts. Default 10; 0 keeps only account_contact_count.

Required range: 0 <= x <= 100

fields

string

Comma-separated Account fields to return; omit for all. Reach into a list with a dot (contacts.contact_name, contacts.signals.signal_date). account_id and signal_id always ship.

Maximum string length: 4000

filter

object

Filter on any Account key GET /fields lists: filter[]= (repeat for any of several values) or filter[][]= with eq, ne, contains, gt, gte, lt, lte, exists. Keys inside a list (contacts.contact_job_title, signals.signal_freshness) match when any element matches. Combines with the dedicated filters; all of them must hold.

Show child attributes

page_size

integer

Rows per page, 1-100. Default 25.

Required range: 1 <= x <= 100

offset

integer

Rows to skip, to jump to a position. Cannot be combined with cursor.

Required range: 0 <= x <= 100000

cursor

string

pagination.next_cursor from the previous page. Send only cursor (plus page_size or fields): the query travels inside it.

Required string length: 1 - 8192

Response

data

object

required

Show child attributes

Accounts

Contacts

Analytics

Filters

API Reference

List accounts

Authorizations

Scopes

Query Parameters

Response