Get buying-committee coverage

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "acme": {
      "seats": {
        "economic_buyer": 1,
        "decision_maker": 1,
        "influencer": 1,
        "champion": 2
      },
      "unclassified": 1,
      "bands": 3,
      "total": 6,
      "seated": {
        "economic_buyer": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d1",
            "name": "Priya Nair",
            "title": "Chief Revenue Officer"
          }
        ],
        "decision_maker": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8c9",
            "name": "Theresa Webb",
            "title": "VP of Sales"
          }
        ],
        "influencer": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d2",
            "name": "Marcus Lee",
            "title": "Director of Sales Operations"
          }
        ],
        "champion": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d3",
            "name": "Jordan Kim",
            "title": "Account Executive"
          },
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d4",
            "name": "Sam Ortiz",
            "title": "SDR Manager"
          }
        ]
      }
    },
    "globex": {
      "seats": {},
      "unclassified": 0,
      "bands": 0,
      "total": 0,
      "seated": {}
    }
  }
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Tasks

Get buying-committee coverage

Reports, for each account you name, which buying-committee seats the team’s contacts at that account fill.

The seats are economic buyer, decision maker, influencer and champion, read from each contact’s job title through the team’s buying-committee map (GET /v2/sequencer/settings) or the shipped defaults. Every contact on the team at the account counts, whether or not it is in a sequence.

Pass up to 100 identifiers in account_keys; extra ones are ignored, and an empty or missing value returns an empty data. Each identifier matches a contact’s normalized company name (contact.account_key on a task row) or, exactly, its company name (contact.account), and the answer comes back keyed by the string you sent. At most 2,000 contacts are read per request. Counts against the Sequencer reads rate limit.

GET

sequencer

tasks

account-coverage

Get buying-committee coverage

curl --request GET \
  --url https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage \
  --header 'x-api-key: <api-key>'

import requests

url = "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://client-api.salesfinity.co/v2/sequencer/tasks/account-coverage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "acme": {
      "seats": {
        "economic_buyer": 1,
        "decision_maker": 1,
        "influencer": 1,
        "champion": 2
      },
      "unclassified": 1,
      "bands": 3,
      "total": 6,
      "seated": {
        "economic_buyer": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d1",
            "name": "Priya Nair",
            "title": "Chief Revenue Officer"
          }
        ],
        "decision_maker": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8c9",
            "name": "Theresa Webb",
            "title": "VP of Sales"
          }
        ],
        "influencer": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d2",
            "name": "Marcus Lee",
            "title": "Director of Sales Operations"
          }
        ],
        "champion": [
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d3",
            "name": "Jordan Kim",
            "title": "Account Executive"
          },
          {
            "_id": "66f9b1e0a2c3d4e5f6a7b8d4",
            "name": "Sam Ortiz",
            "title": "SDR Manager"
          }
        ]
      }
    },
    "globex": {
      "seats": {},
      "unclassified": 0,
      "bands": 0,
      "total": 0,
      "seated": {}
    }
  }
}

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Rate limit of 300 requests per minute exceeded. Retry in 12s.",
  "error": "Too Many Requests",
  "statusCode": 429,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Internal server error",
  "error": "Internal Server Error",
  "statusCode": 500,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service unreachable",
  "error": "Bad Gateway",
  "statusCode": 502,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

{
  "message": "Sequencer service timed out",
  "error": "Gateway Timeout",
  "statusCode": 504,
  "request_id": "0f6d3c52-9f3e-4c1a-a4b8-2b1f7e5d9c10"
}

Shows how well the team is threaded into each account: which buying-committee seats its contacts there already fill, and which are empty.

Example

GET /v2/sequencer/tasks/account-coverage?account_keys=acme,globex Take the identifiers from task rows you already have: each task’s contact.account_key, or contact.account when there is no key. The response is keyed by exactly the strings you sent, so you can join it back to your rows without normalizing anything.

Reading the response

Field	Meaning
`seats`	How many contacts fill each seat: `economic_buyer`, `decision_maker`, `influencer`, `champion`.
`seated`	Who they are, up to 8 per seat, with `_id`, `name` and `title`.
`bands`	How many of the three levels are covered: champion; influencer; decision maker or economic buyer. `1` means single-threaded.
`unclassified`	Contacts whose title maps to no seat.
`total`	Contacts matched at the account.

Good to know

Seats come from job titles, read through the team’s buying-committee map in Get sequencer settings, or the shipped defaults when the team has none.
Every contact on the team at the account counts, whether or not it is in a sequence.
Up to 100 identifiers and 2,000 contacts per request. Split a larger page of rows into several calls.
Identifiers are split on commas, so a company name that contains one, such as Acme, LLC, must be sent as its normalized key (acme).

Authorizations

x-api-key

string

header

required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Query Parameters

account_keys

string

Comma-separated account identifiers, up to 100. Each is a normalized company name as carried on a task's contact.account_key (lowercase, punctuation and legal suffixes removed, so Acme, LLC is acme), or a company name exactly as stored in contact.account. A company name containing a comma cannot be sent this way; use its normalized form.

Response

Coverage per account.

data

object

required

One entry per identifier sent, keyed by that identifier exactly as sent.

Show child attributes

Get started

MCP server

MCP reference

MCP use cases

Dialer API

Calls and analytics API

Enrichment API

Sequencer API

Get buying-committee coverage

Example

Reading the response

Good to know

Authorizations

Query Parameters

Response

​Example

​Reading the response

​Good to know

Authorizations

Query Parameters

Response

Example

Reading the response

Good to know