ByDomuDevelopers
Create key

Detalle de contacto

GEThttps://api.bydomu.com/v1/contacts/{id}

This reference is generated from the API’s code, so descriptions are in Spanish. Names, parameters and examples are the same in every language.

Ficha completa: dueño, últimos 5 negocios, etiquetas, relaciones con otros contactos, origen, negocio abierto y enlaces compartidos. Nunca incluye mensajes ni el token del portal del comprador.

Permission
contacts:read
Keys
Secret only (server-side)

Headers

X-API-Keystringrequired
Your secret key.

Path parameters

idstringrequired
ID del contacto

Responses

200El contacto
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
404NOT_FOUND · El recurso no existe en la organización.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/contacts/clx1con001" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/contacts/clx1con001", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/contacts/clx1con001",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Response · 200 · example
{
  "data": {
    "id": "clx1con001",
    "code": "C-0107",
    "firstName": "María",
    "lastName": "González",
    "email": "[email protected]",
    "phone": "+573001234567",
    "phone2": "+573109876543",
    "source": "WHATSAPP",
    "status": "NEW",
    "type": "CLIENT",
    "documentType": "CC",
    "documentNumber": "1020304050",
    "score": 75,
    "notes": "Busca apartamento cerca al trabajo.",
    "budget": "350000000.00",
    "currency": "COP",
    "lookingFor": "Apartamento de 3 habitaciones",
    "preferredType": "APARTMENT",
    "preferredCity": "Bogotá",
    "preferredNeighborhood": "Chapinero",
    "minBedrooms": 3,
    "minBathrooms": 2,
    "minArea": 70,
    "preferredTransactionType": "SALE",
    "subscribedToAlerts": true,
    "whatsappOptIn": true,
    "marketingOptIn": false,
    "ownerId": "clx1usr001",
    "createdAt": "2026-01-15T14:30:00.000Z",
    "updatedAt": "2026-09-20T09:15:00.000Z",
    "owner": {
      "id": "clx1usr001",
      "firstName": "Carlos",
      "lastName": "Rodríguez",
      "email": "[email protected]"
    },
    "deals": [
      {
        "id": "clx1deal001",
        "title": "Venta Apto Chapinero",
        "status": "OPEN",
        "value": "350000000.00",
  …

The key goes in the BYDOMU_API_KEY variable. The example data belongs to no agency.