Get a contact

Devuelve información de un contacto existente

Retrieves the information of an existing contact.

GET /v2/contact/{identifier}

Provide your bearer token in the Authorization header when making requests to protected resources. Example: Authorization: Bearer 123

Identifier of the contact that can either be a phone number, email or contact ID. Examples: id:123 , email:[email protected] , phone:[phone]

Path Parameters

Name	Type	Description
identifier*	String

Headers

Name	Type	Description
Token	Bearer token

200: OK

{
  "id": 12345,
  "firstName": "Juan",
  "lastName": "Perez",
  "phone": "[phone]",
  "email": "[email protected]",
  "language": "es",
  "profilePic": "https://cdn.ecuabots.com/profile_avatar.png",
  "countryCode": "EC",
  "custom_fields": [
    {
      "name": "Company Website",
      "value": "https://example.com"
    }
  ],
  "status": "open",
  "tags": [
    "new_customer, sales"
  ],
  "assignee": {
    "id": 12345,
    "firstName": "Juan",
    "lastName": "Perez",
    "email": "[email protected]"
  },
  "created_at": 1663274081
}

400: Bad Request

{
  "code": 400,
  "message": "Validation error."
}

401: Unauthorized

{
  "code": 401,
  "message": "UN_AUTHORIZED"
}

404: Not Found

{
  "code": 404,
  "message": "Contact not found"
}

500: Internal Server Error

{
  "code": 500,
  "message": "Unexpected error occurred"
}

Ejemplo de la petición:

curl --request GET \
  --url https://api.chatapi.net/v2/contact/identifier \
  --header 'Authorization: Bearer 123456789012345678901234567890' \
  --header 'Content-Type: application/json'

Respuesta - Success (HTTP status → 200)

{
  "id": 12345,
  "firstName": "Juan",
  "lastName": "Perez",
  "phone": "[phone]",
  "email": "[email protected]",
  "language": "es",
  "profilePic": "https://cdn.ecuabots.com/profile_avatar.png",
  "countryCode": "EC",
  "custom_fields": [
    {
      "name": "Company Website",
      "value": "https://example.com"
    }
  ],
  "status": "open",
  "tags": [
    "new_customer, sales"
  ],
  "assignee": {
    "id": 12345,
    "firstName": "Juan",
    "lastName": "Perez",
    "email": "[email protected]"
  },
  "created_at": 1663274081
}