curl --request GET \
--url https://api.statisfy.com/v1/outreach_emails \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.statisfy.com/v1/outreach_emails"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.statisfy.com/v1/outreach_emails', 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.statisfy.com/v1/outreach_emails",
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: Bearer <token>"
],
]);
$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.statisfy.com/v1/outreach_emails"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.statisfy.com/v1/outreach_emails")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/outreach_emails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"outcome": {
"bounce_reason": "<string>",
"clicked_at": "<string>",
"delivered_at": "<string>",
"delivery": "processed",
"opened_at": "<string>",
"opted_out_at": "<string>",
"replied_at": "<string>"
},
"status": "sent",
"to": {
"contact_id": "<string>",
"email": "<string>",
"name": "<string>"
},
"worker": {
"id": "<string>",
"name": "<string>"
},
"account_id": "<string>",
"approval": {
"approved_at": "<string>",
"approved_by": "<string>"
},
"cc": [
{
"contact_id": "<string>",
"email": "<string>",
"name": "<string>"
}
],
"conversation_id": "<string>",
"from_email": "<string>",
"sent_at": "<string>",
"sent_via": "company_address",
"subject": "<string>"
}
],
"has_more": false,
"next_cursor": "<string>"
}List outreach emails
Pages through the emails your digital workers sent unprompted, newest first. Filter with filter[<key>][<op>]=<value> (conditions are ANDed; in repeats the parameter): worker, account, contact (ids; eq or in), sent_at (a date, YYYY-MM-DD, UTC days; eq, gt, gte, lt or lte), status (sent, sending, unknown; eq or in), replied (true: answered; false: sent on a recorded thread and not answered; eq). Anything else is a 422. With replied, a page reads at most 2,000 emails, so it can hold fewer than limit while has_more is true: page on with next_cursor. An outreach email is one a digital worker sent unprompted, to one contact (with any cc), about one account. status is sent, sending, or unknown (the mail provider never confirmed it). approval is null when the worker sent it on its own, else who sent its draft after review. outcome says what became of it: the customer’s reply on its thread, how far it got and whether a person opened it or clicked (emails from the worker’s company address only: a connected mailbox reports none of it), and whether the recipient opted out after it. conversation_id is its conversation once it has one.
curl --request GET \
--url https://api.statisfy.com/v1/outreach_emails \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.statisfy.com/v1/outreach_emails"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.statisfy.com/v1/outreach_emails', 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.statisfy.com/v1/outreach_emails",
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: Bearer <token>"
],
]);
$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.statisfy.com/v1/outreach_emails"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.statisfy.com/v1/outreach_emails")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.statisfy.com/v1/outreach_emails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"outcome": {
"bounce_reason": "<string>",
"clicked_at": "<string>",
"delivered_at": "<string>",
"delivery": "processed",
"opened_at": "<string>",
"opted_out_at": "<string>",
"replied_at": "<string>"
},
"status": "sent",
"to": {
"contact_id": "<string>",
"email": "<string>",
"name": "<string>"
},
"worker": {
"id": "<string>",
"name": "<string>"
},
"account_id": "<string>",
"approval": {
"approved_at": "<string>",
"approved_by": "<string>"
},
"cc": [
{
"contact_id": "<string>",
"email": "<string>",
"name": "<string>"
}
],
"conversation_id": "<string>",
"from_email": "<string>",
"sent_at": "<string>",
"sent_via": "company_address",
"subject": "<string>"
}
],
"has_more": false,
"next_cursor": "<string>"
}Authorizations
An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.
Query Parameters
Was this page helpful?