Listar comisiones

GEThttps://api.bydomu.com/v1/commissions

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.

Comisiones de la organización con filtros por estado, agente, negocio y fecha de cierre (pageSize máximo 500).

Permissão

commissions:read

Chaves

Só secreta (de um servidor)

Cabeçalhos

X-API-Keystringobrigatório

Sua chave secreta.

Parâmetros de consulta

pageinteger

Página, desde 1 · default=1 · ≥ 1

pageSizeinteger

Comisiones por página (máximo 500) · default=20 · 1–500

cursorstring

Se valida pero no se aplica en esta operación

includeTotalboolean | string

Se valida pero no se aplica en esta operación

sortBystring

Campo de orden (por defecto closedAt) · default="createdAt"

sortOrderstring

Dirección del orden ascdesc · default="desc"

searchstring

Referencia, título o código del negocio, o código de su propiedad

statusstring

Estado de la comisión PENDIENTEFACTURADAPAGADA_PARCIALPAGADACANCELADA

agentIdstring

Agente del negocio

dateFromstring

Cerradas desde esta fecha (ISO 8601) · nullable

dateTostring

Cerradas hasta esta fecha (ISO 8601) · nullable

dealIdstring

Negocio

Respostas

200Página de comisiones

400Datos inválidos: el cuerpo o la query no cumplen el esquema, o `Idempotency-Key` está mal formada.

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.

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.

{ "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", "agent": { "id": "clx1usr001", "name": "Carlos Rodríguez" }, "contact": { "id": "clx1con001", "firstName": "María", "lastName": "González" }, "properties": [ { "property": { "id": "clx1prop001", "title": "Apartamento en Chapinero con vista", "transactionType": "SALE" } …