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

# Get Partner Contacts

> Retrieve all contacts associated with partner companies

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://app.journeybee.io/api/v1/contacts" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json"
  ```
</CodeGroup>

## Query Parameters

<ParamField query="partnership_id" type="number">
  Filter contacts by specific partnership
</ParamField>

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

## Response Schema

<ResponseField name="contacts" type="array">
  Array of contact objects

  <Expandable title="Contact Object">
    <ResponseField name="id" type="number">Contact ID</ResponseField>
    <ResponseField name="uuid" type="string">Contact UUID</ResponseField>
    <ResponseField name="email" type="string">Contact email</ResponseField>
    <ResponseField name="first_name" type="string">Contact first name</ResponseField>
    <ResponseField name="last_name" type="string">Contact last name</ResponseField>
    <ResponseField name="position" type="string">Job title/position</ResponseField>
    <ResponseField name="phone_number" type="string">Contact phone number</ResponseField>
    <ResponseField name="company_name" type="string">Partner company name</ResponseField>
    <ResponseField name="partnership_id" type="number">Associated partnership ID</ResponseField>
    <ResponseField name="tags" type="array">Array of assigned tags</ResponseField>
    <ResponseField name="custom_fields" type="array">Array of custom field values</ResponseField>
  </Expandable>
</ResponseField>

## Example Response

<ResponseExample>
  ```json 200 OK theme={null}
  [
    {
      "id": 123,
      "uuid": "contact-uuid-123",
      "email": "john@partner.com",
      "first_name": "John",
      "last_name": "Smith",
      "position": "Partnership Manager",
      "phone_number": "+1-555-123-4567",
      "company_name": "Partner Corp",
      "partnership_id": 456,
      "tags": [
        {
          "id": 5,
          "label": "Key Contact",
          "background_color": "#10B981"
        }
      ],
      "custom_fields": []
    }
  ]
  ```
</ResponseExample>

## Notes

* Requires API key with `read_access` permission
* Contacts are associated with partner companies through partnerships
* Used for communication and relationship management