Detailed Information

Get the full picture on any person or account using the MadKudu ID

Use these endpoints to fetch rich context about a person or account using the MadKudu ID. Perfect for surfacing firmographics, demographics, engagement metrics, and scores in your tools or workflows

Get Account By Id

get

/accounts/{mk_id}

Retrieve comprehensive account information including firmographics, customer fit scoring, activity metrics, and contact details.

Authorizations

x-api-keystringRequired

Path parameters

mk_idstringRequired

Responses

200

The request has succeeded.

application/json

mk_idstringRequired

Unique identifier for the account in MadKudu

namestringRequired

Account name

domainstringRequired

Account domain

logostringOptional

Logo URL

descriptionstringOptional

Account description

industrystringOptional

Industry

founded_yearinteger · int32Optional

Founded year

raised_amountnumber · doubleOptional

Raised amount

employees_countinteger · int32Optional

Number of employees

active_usersinteger · int32Optional

Number of active users

activities_countinteger · int32Optional

Total activities count

aggregationsobjectRequired

Aggregations data

get

/accounts/{mk_id}

GET /accounts/{mk_id} HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*

200

The request has succeeded.

{
  "mk_id": "salesforce_Account_Id_0011K000027UadJQAS",
  "source_system": {
    "id": "0011K000027UadJQAS",
    "system": "salesforce",
    "object": "Account"
  },
  "name": "MadKudu",
  "domain": "madkudu.com",
  "logo": "https://logo.clearbit.com/madkudu.com",
  "description": "MadKudu provides a customer data platform that enables sales and customer success teams to identify and act on buying signals quickly enhancing their ability to engage with customers and reduce churn through automated insights and actions",
  "industry": "Internet Software & Services",
  "founded_year": 2014,
  "raised_amount": 27100000,
  "employees_count": 52,
  "active_users": 48,
  "activities_count": 434415,
  "socials": {
    "linkedin_handle": "company/madkudu",
    "twitter_handle": "madkudu",
    "crunchbase_handle": "organization/madkudu",
    "website": "https://madkudu.com"
  },
  "location": {
    "country": "United States",
    "state": "",
    "city": "Mountain View"
  },
  "scores": {
    "customer_fit": {
      "score": 49,
      "segment": "low",
      "signals": "✅ Company likely using Salesforce \n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n✅ Company industry is Software \n❌ Website traffic is medium large (10k-100k visitors/month) "
    },
    "likelihood_to_buy": {
      "score": 100,
      "segment": "very high"
    }
  },
  "aggregations": {}
}

Get Account Activities

post

/accounts/{mk_id}/activities

Get activities associated with an account including website visits, email engagement, product usage, and sales touchpoints. Filter by activity type, date range, or specific team members.

Authorizations

x-api-keystringRequired

Path parameters

mk_idstringRequired

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicstring · enumOptional

Filter logic

Possible values:

Responses

200

The request has succeeded.

application/json

post

/accounts/{mk_id}/activities

POST /accounts/{mk_id}/activities HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "limit": 10,
  "cursor": 20,
  "search": "MSI",
  "filters": [
    {
      "property": "activity_type",
      "operator": "NOT_IN",
      "value": [
        "Job Activity"
      ]
    }
  ],
  "filterLogic": "AND",
  "sort": [
    {
      "sort_by": "name",
      "sort_order": "asc"
    }
  ]
}

200

The request has succeeded.

{
  "data": [
    {
      "event_id": "624a8797f10aeb9acc239104c3a521fe",
      "event": "Opened MSI Email Digest",
      "event_display": "Opened Copilot Email Digest",
      "event_timestamp": "2025-03-05T18:48:13",
      "activity_type": "App Usage",
      "account_id": "salesforce_Account_Id_0011K000027UadJQAS",
      "person": {
        "mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
        "source_system": {
          "id": "00Q1K000011Oac0UAC",
          "system": "salesforce",
          "object": "Lead"
        },
        "email": "francis@madkudu.com",
        "name": "Francis Brero",
        "first_name": "Francis",
        "last_name": "Brero",
        "title": "Co-founder",
        "persona": "",
        "avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
        "company": {
          "domain": "madkudu.com",
          "mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
        },
        "socials": {
          "linkedin_handle": "in/francisbrero",
          "twitter_handle": "",
          "crunchbase_handle": "",
          "website": ""
        },
        "location": {
          "country": "United States",
          "state": "",
          "city": "Mountain View"
        },
        "has_left_company": false,
        "scores": {
          "customer_fit": {
            "score": 49,
            "segment": "low",
            "signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
          },
          "likelihood_to_buy": {
            "score": 96,
            "segment": "very high"
          }
        },
        "activities": 11974,
        "aggregations": {}
      }
    }
  ],
  "meta": {
    "limit": 10,
    "has_next_page": true,
    "next_cursor": 30
  }
}

Get Account Top Persons

get

/accounts/{mk_id}/top-persons

Fetch the most engaged contacts at a company, ranked by activity level and seniority. Helps identify champions, decision makers, and active stakeholders for targeted outreach and relationship building.

Authorizations

x-api-keystringRequired

Path parameters

mk_idstringRequired

Query parameters

limitinteger · int32Optional

Responses

200

The request has succeeded.

application/json

mk_idstringRequired

Unique identifier for the person in MadKudu

emailstringRequired

Email address

namestringRequired

Full name

first_namestringOptional

First name

last_namestringOptional

Last name

titlestringOptional

Job title

personastringOptional

Persona

avatarstringOptional

Avatar URL

has_left_companybooleanOptional

Has left company

activitiesanyOptional

Activities information

aggregationsobjectRequired

Aggregations data

get

/accounts/{mk_id}/top-persons

GET /accounts/{mk_id}/top-persons HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*

200

The request has succeeded.

[
  {
    "mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
    "source_system": {
      "id": "00Q1K000011Oac0UAC",
      "system": "salesforce",
      "object": "Lead"
    },
    "email": "francis@madkudu.com",
    "name": "Francis Brero",
    "first_name": "Francis",
    "last_name": "Brero",
    "title": "Co-founder",
    "persona": "",
    "avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
    "company": {
      "domain": "madkudu.com",
      "mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
    },
    "socials": {
      "linkedin_handle": "in/francisbrero",
      "twitter_handle": "",
      "crunchbase_handle": "",
      "website": ""
    },
    "location": {
      "country": "United States",
      "state": "",
      "city": "Mountain View"
    },
    "has_left_company": false,
    "scores": {
      "customer_fit": {
        "score": 49,
        "segment": "low",
        "signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
      },
      "likelihood_to_buy": {
        "score": 96,
        "segment": "very high"
      }
    },
    "activities": 11974,
    "aggregations": {}
  }
]

Get Person By Id

get

/persons/{mk_id}

Retrieve comprehensive person information including job details, company background, engagement scoring, and activity metrics.

Authorizations

x-api-keystringRequired

Path parameters

mk_idstringRequired

Responses

200

The request has succeeded.

application/json

mk_idstringRequired

Unique identifier for the person in MadKudu

emailstringRequired

Email address

namestringRequired

Full name

first_namestringOptional

First name

last_namestringOptional

Last name

titlestringOptional

Job title

personastringOptional

Persona

avatarstringOptional

Avatar URL

has_left_companybooleanOptional

Has left company

activitiesanyOptional

Activities information

aggregationsobjectRequired

Aggregations data

get

/persons/{mk_id}

GET /persons/{mk_id} HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Accept: */*

200

The request has succeeded.

{
  "mk_id": "salesforce_Lead_Id_00Q1K000011Oac0UAC",
  "source_system": {
    "id": "00Q1K000011Oac0UAC",
    "system": "salesforce",
    "object": "Lead"
  },
  "email": "francis@madkudu.com",
  "name": "Francis Brero",
  "first_name": "Francis",
  "last_name": "Brero",
  "title": "Co-founder",
  "persona": "",
  "avatar": "https://d1ts43dypk8bqh.cloudfront.net/v1/avatars/50eb56e0-cc77-4468-a133-a685c8ed5715",
  "company": {
    "domain": "madkudu.com",
    "mk_id": "salesforce_Account_Id_0011K000027UadJQAS"
  },
  "socials": {
    "linkedin_handle": "in/francisbrero",
    "twitter_handle": "",
    "crunchbase_handle": "",
    "website": ""
  },
  "location": {
    "country": "United States",
    "state": "",
    "city": "Mountain View"
  },
  "has_left_company": false,
  "scores": {
    "customer_fit": {
      "score": 49,
      "segment": "low",
      "signals": "✅ Company likely using Salesforce \n✅ Title is Co-founder\n✅ Company likely using HubSpot\n✅ Company likely using Segment\n✅ Company size is 52\n❌ Website traffic is medium large (10k-100k visitors/month) "
    },
    "likelihood_to_buy": {
      "score": 96,
      "segment": "very high"
    }
  },
  "activities": 11974,
  "aggregations": {}
}

Get Person Activities

post

/persons/{mk_id}/activities

Get activities associated with a person including email opens, website visits, content downloads, and meeting attendance. Filter by activity type or date range to understand engagement patterns and optimize outreach timing.

Authorizations

x-api-keystringRequired

Path parameters

mk_idstringRequired

Body

limitinteger · int32Optional

Number of results to return

cursorinteger · int32Optional

Cursor for pagination

searchstringOptional

Search query

filterLogicstring · enumOptional

Filter logic

Possible values:

Responses

200

The request has succeeded.

application/json

post

/persons/{mk_id}/activities

POST /persons/{mk_id}/activities HTTP/1.1
Host: madapi.madkudu.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 192

{
  "limit": 10,
  "cursor": 20,
  "search": "MSI",
  "filters": [
    {
      "property": "activity_type",
      "operator": "NOT_IN",
      "value": [
        "Job Activity"
      ]
    }
  ],
  "filterLogic": "AND",
  "sort": [
    {
      "sort_by": "name",
      "sort_order": "asc"
    }
  ]
}

200

The request has succeeded.

{
  "data": [
    {
      "event_id": "624a8797f10aeb9acc239104c3a521fe",
      "event": "Opened MSI Email Digest",
      "event_display": "Opened Copilot Email Digest",
      "event_timestamp": "2025-03-05T18:48:13",
      "activity_type": "App Usage",
      "account_id": "salesforce_Account_Id_0011K000027UadJQAS"
    }
  ],
  "meta": {
    "limit": 10,
    "has_next_page": true,
    "next_cursor": 30
  }
}

PreviousLookup NextEnrichment

Last updated 10 months ago

Was this helpful?