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. Retrieves detailed information about an account by its ID within a specified tenant.
Authorizations
Path parameters
account_idstringRequired
Responses
200
The request has succeeded.
application/json
get
GET /accounts/{account_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 person by ID. Retrieves detailed information about a person by their ID within a specified tenant.
Authorizations
Path parameters
person_idstringRequired
Responses
200
The request has succeeded.
application/json
get
GET /persons/{person_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": "[email protected]",
"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 activities associated with a person with pagination, search, filter, and sort.
Authorizations
Path parameters
person_idstringRequired
Body
limitinteger · int32Optional
Number of results to return
cursorinteger · int32Optional
Cursor for pagination
searchstringOptional
Search query
filterLogicstring · enumOptionalPossible values:
Filter logic
Responses
200
The request has succeeded.
application/json
post
POST /persons/{person_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
}
}Get activities associated with an account with pagination, search, filter, and sort.
Authorizations
Path parameters
account_idstringRequired
Body
limitinteger · int32Optional
Number of results to return
cursorinteger · int32Optional
Cursor for pagination
searchstringOptional
Search query
filterLogicstring · enumOptionalPossible values:
Filter logic
Responses
200
The request has succeeded.
application/json
post
POST /accounts/{account_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": "[email protected]",
"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 top persons associated with an account.
Authorizations
Path parameters
account_idstringRequired
Query parameters
limitinteger · int32Optional
Responses
200
The request has succeeded.
application/json
get
GET /accounts/{account_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": "[email protected]",
"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": {}
}
]Last updated
Was this helpful?