> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Contacts

> List all contacts for the authenticated user

## 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.

<Note>
  **Scope required:** `contacts:read` | **Rate limit:** 60 requests/min
</Note>

## Request

```bash theme={null}
GET /v1/contacts
```

### Query Parameters

<ParamField query="limit" type="number" default="25">
  Results per page (max 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number of results to skip for pagination
</ParamField>

<ParamField query="relationship" type="string">
  Filter by relationship type. One of: `RECRUITER`, `HIRING_MANAGER`, `HR_MANAGER`, `TEAM_LEAD`, `DEPARTMENT_HEAD`, `CEO_FOUNDER`, `COLLEAGUE`, `FRIEND`, `REFERRAL`, `OTHER`
</ParamField>

<ParamField query="search" type="string">
  Search by first name, last name, company, or email (case-insensitive)
</ParamField>

### Example

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

## Response

<ResponseField name="data" type="array">
  Array of contacts

  <Expandable>
    <ResponseField name="id" type="string">Unique contact ID</ResponseField>
    <ResponseField name="firstName" type="string">First name</ResponseField>
    <ResponseField name="lastName" type="string">Last name</ResponseField>
    <ResponseField name="jobTitle" type="string">Contact's job title</ResponseField>
    <ResponseField name="company" type="string">Company name</ResponseField>
    <ResponseField name="relationship" type="string">Relationship type</ResponseField>
    <ResponseField name="email" type="string">Email address</ResponseField>
    <ResponseField name="phone" type="string">Phone number</ResponseField>
    <ResponseField name="linkedIn" type="string">LinkedIn profile URL</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 creation date</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 last update date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="number">Total number of contacts</ResponseField>
<ResponseField name="hasMore" type="boolean">Whether more pages are available</ResponseField>
<ResponseField name="limit" type="number">Current page size</ResponseField>
<ResponseField name="offset" type="number">Current offset</ResponseField>

```json theme={null}
{
  "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
}
```