ByDomuDevelopers
Criar chave

Detalle de negocio

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

Esta referência é gerada a partir do código da API, por isso as descrições estão em espanhol. Nomes, parâmetros e exemplos são iguais em qualquer idioma.

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

Permissão
deals:read
Chaves
Só secreta (de um servidor)

Cabeçalhos

X-API-Keystringobrigatório
Sua chave secreta.

Parâmetros de rota

idstringobrigatório
ID del negocio

Respostas

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()
Resposta · 200 · exemplo
{
  "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": [
  …

A chave vai na variável BYDOMU_API_KEY. Os dados do exemplo não são de nenhuma imobiliária.