Skip to main content
GET
/
v1
/
contacts
List Contacts
curl --request GET \
  --url https://api.mokaru.ai/v1/contacts
{
  "data": [
    {
      "id": "<string>",
      "firstName": "<string>",
      "lastName": "<string>",
      "jobTitle": "<string>",
      "company": "<string>",
      "relationship": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "linkedIn": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "total": 123,
  "hasMore": true,
  "limit": 123,
  "offset": 123
}

​
Overview

The List Contacts endpoint returns all contacts in your Mokaru account. Use this to find contacts by name, company, or relationship type. Common use cases:
  • AI agent networking - let your AI agent look up contacts at a company before you apply for a job.
  • Contact search - find recruiters, hiring managers, or referrals across your network.
  • CRM sync - export your Mokaru contacts to an external CRM or spreadsheet.
Scope required: contacts:read | Rate limit: 60 requests/min

​
Request

GET /v1/contacts

​
Query Parameters

​
limit
number
default:"25"
Results per page (max 100)
​
offset
number
default:"0"
Number of results to skip for pagination
​
relationship
string
Filter by relationship type. One of: RECRUITER, HIRING_MANAGER, HR_MANAGER, TEAM_LEAD, DEPARTMENT_HEAD, CEO_FOUNDER, COLLEAGUE, FRIEND, REFERRAL, OTHER
​
search
string
Search by first name, last name, company, or email (case-insensitive)

​
Example

curl "https://api.mokaru.ai/v1/contacts?search=Acme&limit=10" \
  -H "Authorization: Bearer mk_your_key"

​
Response

​
data
array
Array of contacts
​
total
number
Total number of contacts
​
hasMore
boolean
Whether more pages are available
​
limit
number
Current page size
​
offset
number
Current offset
{
  "data": [
    {
      "id": "clx1234...",
      "firstName": "Sarah",
      "lastName": "Jones",
      "jobTitle": "Engineering Manager",
      "company": "Acme Corp",
      "relationship": "HIRING_MANAGER",
      "email": "sarah@acme.com",
      "phone": "+1 555-0200",
      "linkedIn": "https://linkedin.com/in/sarahjones",
      "createdAt": "2026-03-10T10:00:00.000Z",
      "updatedAt": "2026-03-15T14:30:00.000Z"
    }
  ],
  "total": 12,
  "hasMore": true,
  "limit": 10,
  "offset": 0
}