# Letterdrop API

> Developer docs for the Letterdrop API: read your workspace's Competitor Monitoring data.

- [Introduction](https://docs.letterdrop.com/introduction.md): Read your workspace's Competitor Monitoring data over a versioned, read-only REST API.
- [Quickstart](https://docs.letterdrop.com/quickstart.md): Your first requests.
- [Authentication](https://docs.letterdrop.com/authentication.md): Workspace API keys and OAuth tokens.
- [Concepts](https://docs.letterdrop.com/concepts.md): Accounts, contacts, signals and how the fields are named.
- [Filters](https://docs.letterdrop.com/filters.md): Filter on any key, analytics periods and dedicated filters.
- [Choosing fields](https://docs.letterdrop.com/choosing-fields.md): Return only the columns you need.
- [Paging](https://docs.letterdrop.com/paging.md): Cursor pagination over a stable snapshot.
- [Errors](https://docs.letterdrop.com/errors.md): Status codes and error bodies.
- [Webhooks](https://docs.letterdrop.com/webhooks.md): The New Competitor Deal webhook, which shares the API's vocabulary.
- [List accounts](https://docs.letterdrop.com/api-reference/accounts/list-accounts.md): The Competitor Monitoring table: one row per company where someone engaged a competitor, newest signal first. Filters AND together. Returns up to page_size rows and pagination.next_cursor; later pages of the same query are served from cache.
- [Find one account by domain or name](https://docs.letterdrop.com/api-reference/accounts/find-one-account-by-domain-or-name.md): Resolve a company you already know to its account. Send domain (preferred) or name. 404 account_not_found means the company is not in this workspace's table.
- [Get one account](https://docs.letterdrop.com/api-reference/accounts/get-one-account.md): One account by its account_id. Reads only that company, so it is cheaper than a list.
- [Get an account's CRM outreach](https://docs.letterdrop.com/api-reference/accounts/get-an-accounts-crm-outreach.md): Your team's outreach to the account from your CRM: the outreach summary and attribution verdict, the timeline from signal to meeting and opportunity, outreach per contact, and the CRM activities themselves.
- [Get an account's CRM opportunities](https://docs.letterdrop.com/api-reference/accounts/get-an-accounts-crm-opportunities.md): Every CRM opportunity on the account, with our verdict on whether a signal led to it.
- [Get an account's buying committee](https://docs.letterdrop.com/api-reference/accounts/get-an-accounts-buying-committee.md): Decision-makers at the account who have NOT engaged a competitor themselves (contact_type Buying Committee). The account's signals came from other people; never describe them as something these people did.
- [Get an account's job postings](https://docs.letterdrop.com/api-reference/accounts/get-an-accounts-job-postings.md): What the account's job postings say: competitors and software in use, and projects relevant to what you sell.
- [List contacts](https://docs.letterdrop.com/api-reference/contacts/list-contacts.md): One row per person who engaged a competitor: the person, their signals, and their account flattened alongside, as the webhook sends it. Takes the same filters as /accounts. Best fit first unless sorted.
- [Deals and meetings after a signal](https://docs.letterdrop.com/api-reference/analytics/deals-and-meetings-after-a-signal.md): Deals created and meetings booked in the period on accounts with a signal, with the attribution verdict behind each. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Share of new-business pipeline with a signal](https://docs.letterdrop.com/api-reference/analytics/share-of-new-business-pipeline-with-a-signal.md): What share of your open new-business pipeline sits on accounts whose latest competitor signal falls in the period. All null when too much of the pipeline cannot be classified to say. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days…
- [Accounts by priority](https://docs.letterdrop.com/api-reference/analytics/accounts-by-priority.md): How many accounts are talking to competitors, and how many are High, Medium and Nurture priority. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Estimated opportunities you can intercept](https://docs.letterdrop.com/api-reference/analytics/estimated-opportunities-you-can-intercept.md): How many opportunities we expect the accounts with a signal in the period to open, from your own sales-cycle history. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Deal overlap and net new accounts](https://docs.letterdrop.com/api-reference/analytics/deal-overlap-and-net-new-accounts.md): How many accounts already have a deal with you, and how many are net new to your CRM. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Confirmed evaluations](https://docs.letterdrop.com/api-reference/analytics/confirmed-evaluations.md): Accounts your team confirmed are evaluating vendors. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Accounts reached out to](https://docs.letterdrop.com/api-reference/analytics/accounts-reached-out-to.md): How many accounts your team reached out to and heard back from in the period. An account counts when its latest outreach (or reply) falls in the period. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Win rate with and without a signal](https://docs.letterdrop.com/api-reference/analytics/win-rate-with-and-without-a-signal.md): Closed-won rate on deals created in the period with a competitor signal, against those without one. Requires start_date and end_date; takes the same filters as /accounts except the *_within_days and *_older_than_days ones.
- [Every key of an object, and how to select and filter on it](https://docs.letterdrop.com/api-reference/filters/every-key-of-an-object-and-how-to-select-and-filter-on-it.md): Call this first. With object=account (or contact, signal, …) it lists every key the object carries: its type, whether fields= can select it and filter[...] can filter on it, the operators, and the values it takes, with this workspace's competitors, opportunity stages, owners and custom CRM fields fi…
- [New competitor deal](https://docs.letterdrop.com/api-reference/new-competitor-deal.md): Sent by a workflow's Send to Webhook step on payload version v2, once per signal. The body is a WebhookSignal plus any custom fields the step adds.

## OpenAPI Specs

- [openapi](/docs/openapi.json)

## Optional

- [OpenAPI spec](https://api.letterdrop.com/api/v2/openapi.json)
- [llms.txt](https://api.letterdrop.com/api/v2/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.