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

# List Contacts

> Retrieve a list of all contacts.

<Note>
  Retrieve your API Key from your [VozAgent Dashboard](https://app.vozagent.ai/settings/api).
</Note>

## Query parameters

<ParamField query="limit" type="number" default="50">
  Maximum number of items to return. Range: 0-100.
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset for paginating through results.
</ParamField>

<ParamField query="search" type="string">
  Search contacts by name, email, or phone number.
</ParamField>

<ParamField query="tags" type="string[]">
  Filter contacts by tags. Comma-separated list.
</ParamField>

## Response

Returns an array of contact objects with their details including name, email, phone, company, and tags.

<ResponseField name="id" type="string">
  Unique identifier for the contact.
</ResponseField>

<ResponseField name="first_name" type="string">
  Contact's first name.
</ResponseField>

<ResponseField name="last_name" type="string">
  Contact's last name.
</ResponseField>

<ResponseField name="email" type="string">
  Contact's email address.
</ResponseField>

<ResponseField name="phone_number" type="string">
  Contact's phone number in E.164 format.
</ResponseField>

<ResponseField name="company" type="string">
  Company name.
</ResponseField>

<ResponseField name="tags" type="string[]">
  Array of tags assigned to the contact.
</ResponseField>

<ResponseField name="created_at" type="datetime">
  When the contact was created.
</ResponseField>

<ResponseField name="updated_at" type="datetime">
  When the contact was last updated.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl https://api.vozagent.ai/v1/contacts \
    -H "Authorization: Bearer <token>"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": "c1a2b3c4-d5e6-f7a8-b9c0-d1e2f3a4b5c6",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "phone_number": "+15551234567",
      "company": "Acme Outdoor Living",
      "tags": ["lead", "outdoor-living"],
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z"
    },
    {
      "id": "d2b3c4d5-e6f7-a8b9-c0d1-e2f3a4b5c6d7",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@smithlandscaping.com",
      "phone_number": "+15559876543",
      "company": "Smith Landscaping",
      "tags": ["customer", "priority"],
      "created_at": "2024-01-14T14:20:00Z",
      "updated_at": "2024-01-15T10:15:00Z"
    }
  ]
  ```
</ResponseExample>