---
title: "Get Contact"
method: GET
path: "/v1/api/contact/{contact_id}"
tags: ["Contacts"]
deprecated: true
---

# Get Contact

`GET /v1/api/contact/{contact_id}`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v1/api/contact/{contact_id}`
- Auth: API key in header `Authorization`

> **Deprecated.**

**Deprecated.** Use `GET /v2/api/crm/people/{id}` instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Get detailed information for a specific contact by ID.

## Path parameters

- `contact_id` string, required

## Query parameters

- `extend` string

## Response `200`

Contact context retrieved successfully

- GetContactContextResponse: Standard response wrapper for contact context
  - `data` ContactContextApiResponse: Comprehensive contact context including integration data and activity
    - `id` string: Unique contact identifier
    - `name` string, nullable: First name
    - `last_name` string, nullable: Last name
    - `numbers` string[]: List of phone numbers
    - `emails` string[]: List of email addresses
    - `company` object, nullable: Company information
      - `name` string, nullable
      - `id` string, nullable
    - `job_title` string, nullable: Job title
    - `website` string, nullable: Website URL
    - `integration_data` object: Data from connected CRM integrations, keyed by integration type (e.g., HUBSPOT, SALESFORCE, PIPEDRIVE)
    - `custom_properties` object, nullable: Custom properties defined for this contact
    - `engagement` 'ENGAGED' | 'COOLING' | 'COLD', nullable: Engagement level of the contact. Only included when `extend=engagement` is specified.
    - `activity` ContactActivityApiResponse[], nullable: Recent communication activities with this contact (calls and SMS). Only included when `extend=activity` is specified.
      - `type` 'INBOUND_CALL' | 'OUTBOUND_CALL' | 'INBOUND_SMS' | 'OUTBOUND_SMS', required: Type of communication activity. Possible values: - `INBOUND_CALL`: An incoming call from the contact - `OUTBOUND_CALL`: An outgoing call to the contact - `INBOUND_SMS`: An incoming SMS from the contact - `OUTBOUND_SMS`: An outgoing SMS to the contact
      - `made_by` string, nullable: Name of the team member who handled the activity
      - `made_at` string, date-time, required: When the activity occurred (ISO 8601 format)
      - `allo_number` string, nullable: The Allo phone number used for the call. Only present for call activities (INBOUND_CALL, OUTBOUND_CALL).
      - `content` string, nullable: The content/text of the SMS message. Only present for SMS activities (INBOUND_SMS, OUTBOUND_SMS).
    - `conversation_url` string: URL path to retrieve the full conversation history for this contact

## Other responses

- `400`: Bad request
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - API key lacks required scope
- `429`: Too Many Requests - Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v1/api/contact/:contact_id/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)