Skip to main content
GET
Obtener detalle de un contacto
Returns one contact by id. Use GET /v1/contacts to find the id first.

Endpoint

Required scope

contacts:read

Headers

Path parameters

Example request

Response

200 OK

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the contacts:read scope.

404 Not Found

No contact with that id, the contact belongs to a different company, or it was absorbed by a merge.

502 Bad Gateway

The messaging service could not answer.

Operational notes

  • The activity timestamps tell you who spoke last. last_user_message_at is the contact, last_bot_response_at is the assistant, and last_agent_response_at is a human agent. Comparing them is the cheapest way to tell whether a conversation is waiting on you.
  • is_attended flips to true when a human takes over the conversation in the portal.
  • tags are ids, not labels. There is no public endpoint yet to resolve a tag id to its name.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Response

200 - application/json
contact
object
required