List Contacts
Contacts
List Contacts
List all contacts for the authenticated user
GET
List Contacts
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/minRequest
Query Parameters
number
default:"25"
Results per page (max 100)
number
default:"0"
Number of results to skip for pagination
string
Filter by relationship type. One of:
RECRUITER, HIRING_MANAGER, HR_MANAGER, TEAM_LEAD, DEPARTMENT_HEAD, CEO_FOUNDER, COLLEAGUE, FRIEND, REFERRAL, OTHERstring
Search by first name, last name, company, or email (case-insensitive)
Example
Response
array
Array of contacts
number
Total number of contacts
boolean
Whether more pages are available
number
Current page size
number
Current offset
