Skip to main content
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/min

Request

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, OTHER
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