Detalle de comisión

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

La comisión con su negocio, sus participantes (con sus pagos) y los pagos recibidos.

Permiso
commissions:read
Claves
Solo secreta (desde un servidor)

Encabezados

X-API-Keystringobligatorio
Tu clave secreta.

Parámetros de ruta

idstringobligatorio
ID de la comisión

Respuestas

200La comisión
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/commissions/clx1com001" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/commissions/clx1com001", {
  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/commissions/clx1com001",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Respuesta · 200 · ejemplo
{
  "data": {
    "id": "clx1com001",
    "referenceNumber": "COM-2026-0015",
    "status": "PENDIENTE",
    "commissionType": "PERCENTAGE",
    "commissionBase": "PROPERTY_PRICE",
    "baseAmount": "350000000.00",
    "percentage": "3.00",
    "grossAmount": "10500000.00",
    "currency": "COP",
    "reteFuente": "1050000.00",
    "reteIca": "105000.00",
    "reteIva": "0.00",
    "netAmount": "9345000.00",
    "paidAmount": "0.00",
    "invoiceNumber": "FE-1042",
    "invoiceDate": "2026-09-28T00:00:00.000Z",
    "notes": "Pendiente la escritura",
    "closedAt": "2026-09-20T16:00:00.000Z",
    "dealId": "clx1deal001",
    "createdAt": "2026-09-20T16:00:00.000Z",
    "updatedAt": "2026-09-25T10:00:00.000Z",
    "deal": {
      "id": "clx1deal001",
      "code": "N-0031",
      "title": "Venta Apto Chapinero",
      "value": "350000000.00",
      "currency": "COP",
      "closedAt": "2026-09-20T16:00:00.000Z",
      "agent": {
        "id": "clx1usr001",
        "name": "Carlos Rodríguez",
        "email": "[email protected]"
      },
      "contact": {
        "id": "clx1con001",
        "firstName": "María",
        "lastName": "González",
        "phone": "+573001234567",
        "email": "[email protected]",
        "documentNumber": "1020304050"
      },
      "properties": [
  …

La clave va en la variable BYDOMU_API_KEY. Los datos del ejemplo no son de ninguna inmobiliaria.