curl --request GET \
--url https://api.getoneprofile.ai/accounts/{account_key}/people/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.getoneprofile.ai/accounts/{account_key}/people/"
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://api.getoneprofile.ai/accounts/{account_key}/people/', 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://api.getoneprofile.ai/accounts/{account_key}/people/",
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://api.getoneprofile.ai/accounts/{account_key}/people/"
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))
}HttpResponse<String> response = Unirest.get("https://api.getoneprofile.ai/accounts/{account_key}/people/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/accounts/{account_key}/people/")
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": [
{
"data_at": "2023-11-07T05:31:56Z",
"department": "sales",
"email": "<string>",
"email_status": "valid",
"enrolments": [
{
"bounced": true,
"enrolment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"failure_code": "connected_before_withdraw",
"last_sent_at": "2023-11-07T05:31:56Z",
"replied_at": "2023-11-07T05:31:56Z",
"sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequence_name": "<string>",
"status": "pending",
"stop_reason": "reply"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"last_contacted_at": "2023-11-07T05:31:56Z",
"linkedin_url": "<string>",
"matched_on": "website",
"name": "<string>",
"namesake_count": 123,
"namesakes": [
{
"email": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "likely_same",
"linkedin_url": "<string>"
}
],
"replied_at": "2023-11-07T05:31:56Z",
"role": "champion",
"seniority": "executive",
"sources": [
{
"record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"table_name": "<string>"
}
],
"title": "<string>"
}
],
"next_page_cursor": "<string>",
"previous_page_cursor": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}List an account's people
List the people at an account, each once however many tables name them: their name and title, how old that is, the rows they are on, and every sequence they are or were in, with when they were last contacted and when they replied, their title’s seniority and department, what is known of their address, the role a rep set, and the others there going by the same name (namesakes: likely_same when nothing tells them apart, as a merge often leaves one person). search keeps the people whose name, title or address holds the text; the other filters each keep any of their values, and together all of them. Ordered by name, title, seniority (most senior first), department or last_contacted_at; people with nothing in that column come last either way.
curl --request GET \
--url https://api.getoneprofile.ai/accounts/{account_key}/people/ \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.getoneprofile.ai/accounts/{account_key}/people/"
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://api.getoneprofile.ai/accounts/{account_key}/people/', 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://api.getoneprofile.ai/accounts/{account_key}/people/",
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://api.getoneprofile.ai/accounts/{account_key}/people/"
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))
}HttpResponse<String> response = Unirest.get("https://api.getoneprofile.ai/accounts/{account_key}/people/")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getoneprofile.ai/accounts/{account_key}/people/")
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": [
{
"data_at": "2023-11-07T05:31:56Z",
"department": "sales",
"email": "<string>",
"email_status": "valid",
"enrolments": [
{
"bounced": true,
"enrolment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"failure_code": "connected_before_withdraw",
"last_sent_at": "2023-11-07T05:31:56Z",
"replied_at": "2023-11-07T05:31:56Z",
"sequence_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sequence_name": "<string>",
"status": "pending",
"stop_reason": "reply"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"key": "<string>",
"last_contacted_at": "2023-11-07T05:31:56Z",
"linkedin_url": "<string>",
"matched_on": "website",
"name": "<string>",
"namesake_count": 123,
"namesakes": [
{
"email": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "likely_same",
"linkedin_url": "<string>"
}
],
"replied_at": "2023-11-07T05:31:56Z",
"role": "champion",
"seniority": "executive",
"sources": [
{
"record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"table_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"table_name": "<string>"
}
],
"title": "<string>"
}
],
"next_page_cursor": "<string>",
"previous_page_cursor": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>",
"issues": [
{
"input": "<string>",
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Authorizations
Path Parameters
The account's key: its domain (acme.com), or its LinkedIn page (li-co:acme).
1 - 320^(?:[^/.][^/]*|\.[^/.][^/]*|\.\.[^/]+)$Query Parameters
Only people whose title names one of these departments, or none for a title naming none; repeat for several.
14The part of a company a person's title names (review AC-12). None: it names none.
Read off the title's words by a fixed rule (org_chart.title_department).
sales, marketing, customer_success, product, design, engineering, data, it, security, finance, people, operations, legal Only people whose address is one of these (a Verify email column's verdict, or bounced), or none for an address nothing checked; repeat for several.
8What is known of a person's address (review AC-12). None: nothing checked it.
The verdict of the Verify email column over the address on their row, the words that column writes; BOUNCED when an email to them bounced, whatever a check said.
valid, catch_all, risky, unknown, invalid, disposable, bounced Only people another person at the account goes by the same name as: likely_same when nothing tells them apart (likely one person found twice), same_name when each has a LinkedIn profile of their own or the name is short of a full one. A person with both kinds among their namesakes is kept by either; repeat for both.
2What another person at the account going by the same name is to someone (review AC-19).
Names match as their words, case, accents and punctuation gone. LIKELY_SAME: a full name (two words or more, none a lone letter) and nothing tells them apart (at most one of them has a LinkedIn profile), so they are likely one person found twice, as a merge leaves them. SAME_NAME: each has a LinkedIn profile of their own, so they are two people, or the name is short of a full one, which says too little. A placeholder ("LinkedIn Member") is no name, and names no namesakes.
likely_same, same_name Only people a rep gave one of these roles on the org chart, or none for no role; repeat for several.
7The part a rep says a person plays in a deal. None: not known.
champion, budget_holder, decision_maker, influencer, user, blocker Text found in the person's name, title or address.
255Only people whose title's seniority is one of these, or none for no title; repeat for several.
8How senior a person's title says they are (review AC-12). None: no title.
Read off the title's words by a fixed rule (org_chart.title_seniority):
a title with no rank word in it is OTHER, never guessed at.
executive, vp, head, director, manager, senior, other Only people with a row on one of these tables, by id (a table card's View all); repeat for several.
100Only people with one of these titles, whole and in any case (none for no title), as GET .../people/facets/ names them; repeat for several.
100255The number of items to return.
1 <= x <= 100name, title, seniority, department, last_contacted_at asc, desc Set the cursor to the next or previous page. You can get the cursor from the previous page's response.
Response
Successful Response
Was this page helpful?