file-userDetailed 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
chevron-right
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}
200

The request has succeeded.

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
chevron-right
200

The request has succeeded.

application/json
post
/accounts/{mk_id}/activities
200

The request has succeeded.

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
chevron-right
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
200

The request has succeeded.

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
chevron-right
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}
200

The request has succeeded.

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
chevron-right
200

The request has succeeded.

application/json
post
/persons/{mk_id}/activities
200

The request has succeeded.

Last updated

Was this helpful?