API reference

API: Sales floor

Method	Path	What it does	Scope
GET	`/v1/floor/feed`	Wins: meetings booked on calls, deals moved forward or won (a room's members, or everyone's)	`calls:read`
GET	`/v1/floor/leaderboard`	Today, this week or this month (your time zone): dials, connects, connect rate, talk time, conversations of 2 minutes or more, meetings booked, pipeline created. From call activities, dispositions, meetings and deals. A room's board to its members; otherwise you and the people who report to you (owners: everyone)	`calls:read`
POST	`/v1/floor/listens`	Listen to a rep's live call (a manager above them, or an owner when an owner allows it): the monitoring notice plays to the other party first, then your own confirmed phone rings as a silent listener nobody hears (web app only)	`calls:write`
GET	`/v1/floor/listens/:id`	Your listen: its state, the live transcript (when the call guide is on and nobody objected) and your notes (web app only)	`transcripts:read`
POST	`/v1/floor/listens/:id/end`	Stop listening (web app only)	`calls:write`
POST	`/v1/floor/listens/:id/mode`	Switch: monitor (nobody hears you), whisper (only the rep hears you) or barge (both ends hear you) (web app only)	`calls:write`
POST	`/v1/floor/listens/:id/notes`	A note to the rep during the call (shown on their dialer) (web app only)	`calls:write`
GET	`/v1/floor/my-listens`	For the rep: who is listening to your current call, and their notes to you	`calls:read`
GET	`/v1/floor/rooms`	Your sales-floor rooms (owners: every room)	`calls:read`
POST	`/v1/floor/rooms`	Make a room: a team room (owners) or an ad-hoc one (anyone; you're in it)	`calls:write`
DELETE	`/v1/floor/rooms/:id`	Close a room	`calls:write`
GET	`/v1/floor/rooms/:id`	A room: each member's live state from the dialer and the desktop (idle, dialing, on a call and with whom, wrap-up), presence, and whether you may listen in	`calls:read`
PUT	`/v1/floor/rooms/:id`	Change a room (the person who made it, or an owner; team rooms: owners)	`calls:write`
POST	`/v1/floor/rooms/:id/join`	Join an ad-hoc room yourself (its members then see your live state) (web app only)	`calls:write`
POST	`/v1/floor/rooms/:id/leave`	Leave a room (web app only)	`calls:write`

Examples

GET /v1/floor/feed

Wins: meetings booked on calls, deals moved forward or won (a room's members, or everyone's)

curl -s "https://api.closefinch.com/v1/floor/feed" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/feed`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/floor/leaderboard

Today, this week or this month (your time zone): dials, connects, connect rate, talk time, conversations of 2 minutes or more, meetings booked, pipeline created. From call activities, dispositions, meetings and deals. A room's board to its members; otherwise you and the people who report to you (owners: everyone)

curl -s "https://api.closefinch.com/v1/floor/leaderboard" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/leaderboard`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/floor/my-listens

For the rep: who is listening to your current call, and their notes to you

curl -s "https://api.closefinch.com/v1/floor/my-listens" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/my-listens`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/floor/rooms

Your sales-floor rooms (owners: every room)

curl -s "https://api.closefinch.com/v1/floor/rooms" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/rooms`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

POST /v1/floor/rooms

Make a room: a team room (owners) or an ad-hoc one (anyone; you're in it)

curl -s -X POST "https://api.closefinch.com/v1/floor/rooms" \
  -H "Authorization: Bearer $RA_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'

const res = await fetch(`https://api.closefinch.com/v1/floor/rooms`, {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({}), // fields: see the OpenAPI schema
});
const data = await res.json();

DELETE /v1/floor/rooms/$ID

Close a room

curl -s -X DELETE "https://api.closefinch.com/v1/floor/rooms/$ID" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/rooms/${id}`, {
  method: "DELETE",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/floor/rooms/$ID

A room: each member's live state from the dialer and the desktop (idle, dialing, on a call and with whom, wrap-up), presence, and whether you may listen in

curl -s "https://api.closefinch.com/v1/floor/rooms/$ID" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/floor/rooms/${id}`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

PUT /v1/floor/rooms/$ID

Change a room (the person who made it, or an owner; team rooms: owners)

curl -s -X PUT "https://api.closefinch.com/v1/floor/rooms/$ID" \
  -H "Authorization: Bearer $RA_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'

const res = await fetch(`https://api.closefinch.com/v1/floor/rooms/${id}`, {
  method: "PUT",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({}), // fields: see the OpenAPI schema
});
const data = await res.json();

Request and response schemas: https://www.closefinch.com/openapi.json. All resources: API reference.