ByDomuDevelopers
Create key

Detalle de negocio

GEThttps://api.bydomu.com/v1/deals/{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.

Negocio completo con contacto, agente, etapas, propiedades, etiquetas, arriendo, las últimas 20 actividades, los últimos 50 comentarios y todas sus tareas (incluidas las archivadas).

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

Headers

X-API-Keystringrequired
Your secret key.

Path parameters

idstringrequired
ID del negocio

Responses

200El negocio
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/deals/clx1deal001" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/deals/clx1deal001", {
  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/deals/clx1deal001",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Response · 200 · example
{
  "data": {
    "id": "clx1deal001",
    "code": "N-0031",
    "title": "Venta Apto Chapinero - María González",
    "value": "350000000.00",
    "currency": "COP",
    "probability": 40,
    "status": "OPEN",
    "closedAt": "2026-10-30T18:00:00.000Z",
    "expectedCloseDate": "2026-11-30T00:00:00.000Z",
    "lostReason": "Compró con otra inmobiliaria",
    "lostReasonCategory": "COMPETENCIA",
    "intent": "PURCHASE",
    "budgetMin": "300000000.00",
    "budgetMax": "400000000.00",
    "preferredZones": [
      "Chapinero"
    ],
    "propertyTypes": [
      "APARTMENT"
    ],
    "leadSource": "REFERRAL",
    "notes": "Pre-aprobada para crédito hipotecario.",
    "agentId": "clx1usr001",
    "contactId": "clx1con001",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-25T16:45:00.000Z",
    "contact": {
      "id": "clx1con001",
      "firstName": "María",
      "lastName": "González",
      "phone": "+573001234567",
      "email": "[email protected]",
      "source": "WHATSAPP",
      "score": 75,
      "budget": "350000000.00"
    },
    "agent": {
      "id": "clx1usr001",
      "firstName": "Carlos",
      "lastName": "Rodríguez"
    },
    "placements": [
  …

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