Ver el equipo
Quién está en el negocio, con qué rol y en qué sucursal, más las invitaciones pendientes y el cupo de usuarios del plan. Sin correos ni fotos de perfil. Una integración necesita saber quién puede registrar pagos, no la libreta de direcciones del negocio.
Autorización
apiKey team.readLa llave del negocio, creada en el panel: Integraciones → API pública. Formato vk_live_… (o vk_test_… fuera de producción).
Va en: header
Permiso: team.read
Parámetros de consulta
Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios (plan Multi); con uno solo, se deduce.
Cuerpo de la respuesta
application/json
application/json
application/json
curl -X GET "https://example.com/team/members"{ "object": "teamRoster", "members": [ { "object": "teamMember", "id": "cmt7xbfrt000eq3w1q09et8y8", "name": "Laura Gómez", "phone": "+573001112233", "active": true, "role": { "key": "CASHIER", "name": "Cajero", "level": 4 }, "branch": { "id": "cmt7xbfrj0002q3w1iq4ysatr", "name": "Principal" }, "hasPanel": false, "createdAt": "2026-08-25T00:25:22.073Z" } ], "pendingInvitations": [], "seats": { "used": 4, "limit": 20 }}Listar cuentas de recaudo GET
Las cuentas donde el negocio recibe plata. Nunca el número completo: se identifican por su alias y los últimos cuatro, que es todo lo que hace falta para conciliar.
Listar roles GET
Los roles que se pueden asignar, del de más autoridad al de menos. Sin esta lista habría que adivinar la key de un rol para invitar a alguien.