Get Contact

Retrieve a specific contact by UUID, including associated lists and custom fields.

Request

GET /contacts/{uuid}

Path Parameters

Parameter	Type	Description
uuid	string	Contact's UUID

Example Request

curl -X GET "https://email.easy.tools/api/v1/contacts/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response

Success Response (200 OK)

{
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "email": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+48123456789",
    "external_id": "customer_123",
    "language": "en",
    "country_code": "US",
    "lists": [
      {
        "uuid": "list-uuid-1",
        "name": "Newsletter"
      }
    ],
    "custom_fields": [
      {
        "field_key": "company",
        "value": "Acme Inc"
      },
      {
        "field_key": "events-attended",
        "value": ["Webinar X", "Webinar Y"]
      }
    ],
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
}

Response Fields

Field	Type	Description
uuid	string	Contact's unique identifier
email	string	Contact's email address
first_name	string|null	Contact's first name
last_name	string|null	Contact's last name
phone	string|null	Contact's phone number
external_id	string|null	External identifier for integration purposes
language	string|null	ISO 639-1 language code
country_code	string|null	ISO 3166-1 alpha-2 country code
lists	array	Lists the contact belongs to
custom_fields	array	Custom field values for this contact. Each entry has field_key and value; list fields return value as an array of strings.
created_at	string	ISO 8601 timestamp (UTC)
updated_at	string	ISO 8601 timestamp (UTC)

Error Responses

Not Found Error (404)

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Contact with UUID '550e8400-e29b-41d4-a716-446655440000' not found"
  }
}