---
title: "Lookup account by identifiers"
method: GET
path: "/lookup/accounts"
tags: ["Lookup"]
---

# Lookup account by identifiers

`GET /lookup/accounts`

Lookup accounts in your database using domain names, social media handles, or CRM IDs. Returns company profile with contact details, firmographics, and customer fit scoring. Use it to get the MadKudu ID to fetch more information in the Detailed Information endpoints.

## Query parameters

- `domain` string
- `linkedin` string
- `twitter` string
- `crunchbase` string
- `external_id` string

## Response `200`

The request has succeeded.

- AccountDetailsMini[]
  - `mk_id` string, required — Unique identifier for the account in MadKudu
  - `source_system` CommonModelsSourceSystem, required
    - `id` string, required — Unique identifier in the source system
    - `system` string, required — Name of the source system
    - `object` string, required — Object type in the source system
  - `name` string, required — Name of the account
  - `domain` string, required — Domain of the account
  - `logo` string — URL of the account's logo
  - `description` string — Description of the account
  - `industry` string — Industry the account operates in
  - `founded_year` integer — Year the account was founded
  - `raised_amount` number, double — Total amount raised by the account
  - `employees_count` integer — Number of employees in the account
  - `active_users` integer — Number of active users
  - `activities_count` integer — Number of activities
  - `socials` CommonModelsAccountSocials, required
    - `linkedin_handle` string — LinkedIn company handle
    - `twitter_handle` string — Twitter company handle
    - `crunchbase_handle` string — Crunchbase organization handle
    - `website` string — Company website URL
  - `location` CommonModelsLocation, required
    - `country` string — Country
    - `state` string — State or region
    - `city` string — City

## Other responses

- `422` — Client error

---

[API](https://skmtc.net/madkudu/apis/madapi.md) · [All operations](https://skmtc.net/madkudu/apis/madapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/madkudu/madapi/revisions/80a1ceebb4e7/schema)