curl --request GET \
--url https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts';
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts")
.header("Authorization", "<api-key>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"company": "<string>",
"customVars": {},
"email": "<string>",
"firstName": "<string>",
"id": "<string>",
"lastName": "<string>",
"linkedinUrl": "<string>",
"position": "<string>",
"sequences": [
{
"id": "<string>",
"name": "<string>",
"status": "none"
}
],
"tags": [
"<string>"
]
}
],
"limit": 123,
"offset": 123,
"total": 123
}{
"data": [
{
"createdAt": "<string>",
"type": "email",
"value": "<string>"
}
],
"message": "<string>"
}{
"data": [
{
"createdAt": "<string>",
"type": "email",
"value": "<string>"
}
],
"message": "<string>"
}Get contacts
Get contacts associated with the workspace. Supported filters: tag_ids[] (aliases: tagIds), validation_statuses[] (aliases: validationStatus, validationStatuses; valid is accepted as safe), not_in_sequence_id (alias: notInSequenceId). Unknown query parameters return 400. Set pagination=cursor for the first cursor page; pass nextCursor as cursor with the same workspace and filters for subsequent pages. Cursor responses contain data, limit, hasMore and nextCursor (omitted on the last page), without total or offset. Omitting pagination and cursor preserves offset pagination.
curl --request GET \
--url https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts';
const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<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.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts")
.header("Authorization", "<api-key>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://api.salesforge.ai/public/v2/workspaces/{workspaceID}/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"company": "<string>",
"customVars": {},
"email": "<string>",
"firstName": "<string>",
"id": "<string>",
"lastName": "<string>",
"linkedinUrl": "<string>",
"position": "<string>",
"sequences": [
{
"id": "<string>",
"name": "<string>",
"status": "none"
}
],
"tags": [
"<string>"
]
}
],
"limit": 123,
"offset": 123,
"total": 123
}{
"data": [
{
"createdAt": "<string>",
"type": "email",
"value": "<string>"
}
],
"message": "<string>"
}{
"data": [
{
"createdAt": "<string>",
"type": "email",
"value": "<string>"
}
],
"message": "<string>"
}Authorizations
Path Parameters
Workspace ID
Query Parameters
Limit
Offset (cannot be nonzero with cursor pagination)
Pagination mode
offset, cursor Opaque nextCursor from the preceding response; implies cursor pagination
Filter by tag ids
Alias for tag_ids[]
Filter by contacts not in sequence
Alias for not_in_sequence_id
Filter by validation statuses
safe, valid, invalid, disabled, disposable, inbox_full, catch_all, role_account, spamtrap, unknown, unvalidated Alias for validation_statuses[]
safe, valid, invalid, disabled, disposable, inbox_full, catch_all, role_account, spamtrap, unknown, unvalidated 