curl --request GET \
--url https://api.athenahq.ai/api/v1/pitches/{pitch_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.athenahq.ai/api/v1/pitches/{pitch_id}"
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.athenahq.ai/api/v1/pitches/{pitch_id}', 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.athenahq.ai/api/v1/pitches/{pitch_id}",
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.athenahq.ai/api/v1/pitches/{pitch_id}"
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.athenahq.ai/api/v1/pitches/{pitch_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/pitches/{pitch_id}")
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{
"pitch": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"company_name": "Acme Inc",
"company_url": "acme.com",
"company_description": "Acme Inc sells durable industrial widgets to manufacturers.",
"status": "completed",
"created_at": "2026-05-22T15:04:05.000Z",
"country": "United States",
"language": "en",
"type": "pitch_workspace"
},
"competitors": [
{
"id": "11111111-2222-3333-4444-555555555555",
"name": "Competitor Co",
"url": "competitor.com",
"mentions": 42,
"sentiment": 67
}
],
"prompts": [
{
"id": "22222222-3333-4444-5555-666666666666",
"prompt": "What are the best industrial widget manufacturers?",
"type": "discovery"
}
],
"attributes": [
{
"id": "33333333-4444-5555-6666-777777777777",
"attribute_name": "Reliable delivery",
"attribute_type": "positive",
"applies_to": "target",
"count": 12
}
],
"sources": [
{
"domain": "wikipedia.org",
"mentions": 18
}
],
"metrics": {
"total_responses": 120,
"brand_mentions": 64,
"sentiment_score": 72,
"response_rate": 53
}
}{
"error": "Invalid pitch ID format"
}{
"error": "Unauthorized"
}{
"error": "Forbidden: global API key required"
}{
"error": "Pitch not found"
}{
"error": "Unauthorized"
}Get Pitch Report
Returns a single pitch report by ID, including the company metadata, generated prompts, tracked competitors, brand and competitor attributes, top citing sources, and aggregate metrics (brand mentions, sentiment, response rate).
Requires a global (organization-scoped) API key. Website-scoped keys are rejected with 403 Forbidden. Returns 404 Not Found if the pitch does not exist, has been deleted, or belongs to a different organization.
curl --request GET \
--url https://api.athenahq.ai/api/v1/pitches/{pitch_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.athenahq.ai/api/v1/pitches/{pitch_id}"
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.athenahq.ai/api/v1/pitches/{pitch_id}', 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.athenahq.ai/api/v1/pitches/{pitch_id}",
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.athenahq.ai/api/v1/pitches/{pitch_id}"
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.athenahq.ai/api/v1/pitches/{pitch_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/pitches/{pitch_id}")
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{
"pitch": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"company_name": "Acme Inc",
"company_url": "acme.com",
"company_description": "Acme Inc sells durable industrial widgets to manufacturers.",
"status": "completed",
"created_at": "2026-05-22T15:04:05.000Z",
"country": "United States",
"language": "en",
"type": "pitch_workspace"
},
"competitors": [
{
"id": "11111111-2222-3333-4444-555555555555",
"name": "Competitor Co",
"url": "competitor.com",
"mentions": 42,
"sentiment": 67
}
],
"prompts": [
{
"id": "22222222-3333-4444-5555-666666666666",
"prompt": "What are the best industrial widget manufacturers?",
"type": "discovery"
}
],
"attributes": [
{
"id": "33333333-4444-5555-6666-777777777777",
"attribute_name": "Reliable delivery",
"attribute_type": "positive",
"applies_to": "target",
"count": 12
}
],
"sources": [
{
"domain": "wikipedia.org",
"mentions": 18
}
],
"metrics": {
"total_responses": 120,
"brand_mentions": 64,
"sentiment_score": 72,
"response_rate": 53
}
}{
"error": "Invalid pitch ID format"
}{
"error": "Unauthorized"
}{
"error": "Forbidden: global API key required"
}{
"error": "Pitch not found"
}{
"error": "Unauthorized"
}Path Parameters
The UUID of the pitch to retrieve.
Response
Successful response with the full pitch report.
Full pitch report payload returned by GET /api/v1/pitches/{pitch_id}.
A pitch workspace report — org-scoped, returned in lists without the heavy report payload.
Show child attributes
Show child attributes
Competitors tracked on the pitch, with mention counts and sentiment.
Show child attributes
Show child attributes
Prompts generated for the pitch.
Show child attributes
Show child attributes
Positive and negative attributes extracted from the pitch's responses, for both the target company and its competitors.
Show child attributes
Show child attributes
Top 10 citing domains across the pitch's responses, ordered by mention count.
Show child attributes
Show child attributes
Aggregate metrics computed across the pitch's AI responses.
Show child attributes
Show child attributes
Was this page helpful?