GET
/
api
/
v1
/
contacts
Get Partner Contacts
curl --request GET \
  --url https://app.journeybee.io/api/v1/contacts \
  --header 'Authorization: Bearer <token>'
[
  {
    "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": []
  }
]

​
Authentication

curl -X GET "https://app.journeybee.io/api/v1/contacts" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json"

​
Query Parameters

​
partnership_id
number
Filter contacts by specific partnership
​
search
string
Search contacts by name, email, or company

​
Response Schema

​
contacts
array
Array of contact objects

​
Example Response

[
  {
    "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": []
  }
]

​
Notes

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