---
title: "Find decision-makers at a company"
method: POST
path: "/api/v1/contacts/lookup/decision-makers"
tags: ["Lookup"]
---

# Find decision-makers at a company

`POST /api/v1/contacts/lookup/decision-makers`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/contacts/lookup/decision-makers`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns VP/Director/C-level contacts at a company, identified by domain,
company name, or LinkedIn URL. Requires exactly one identifier.
1 credit per contact returned.

## Request body

- object
  - `domain` string: Company domain. Exactly one of domain, company_name, or linkedin_company_url required.
  - `company_name` string
  - `linkedin_company_url` string
  - `limit` integer
  - `offset` integer
  - `require_email` boolean: Always true (contacts without valid email are excluded).
  - `email_status` string[]

## Response `200`

Decision-maker results

- object
  - `ok` boolean
  - `contacts` Contact[]
  - `total_available` integer
  - `query_credits_used` integer
  - `creditsRemaining` integer, nullable
  - `offset` integer
  - `limit` integer
  - `returned` integer
  - `has_more` boolean
  - `next_offset` integer
  - `credits_exhausted` boolean
  - `message` string
  - `code` string
  - `normalized_inputs` object
  - `role_filter` object
    - `seniority` string[]
    - `title_contains` string

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `402`: Insufficient credits or fair-use limit reached

---

[API](https://skmtc.dev/getleads/apis/getleads-api.md) - [All operations](https://skmtc.dev/getleads/apis/getleads-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getleads/apis/getleads-api/revisions/f5dbc32e0c3a?raw)