Skip to main content
GET
/
api
/
v1
/
pitches
/
{pitch_id}
Get Pitch Report
curl --request GET \
  --url https://api.athenahq.ai/api/v1/pitches/{pitch_id} \
  --header 'x-api-key: <api-key>'
{
  "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
  }
}

Authorizations

x-api-key
string
header
required

API key for authentication. You can create one here.

Path Parameters

pitch_id
string<uuid>
required

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}.

pitch
object
required

A pitch workspace report — org-scoped, returned in lists without the heavy report payload.

competitors
object[]
required

Competitors tracked on the pitch, with mention counts and sentiment.

prompts
object[]
required

Prompts generated for the pitch.

attributes
object[]
required

Positive and negative attributes extracted from the pitch's responses, for both the target company and its competitors.

sources
object[]
required

Top 10 citing domains across the pitch's responses, ordered by mention count.

metrics
object
required

Aggregate metrics computed across the pitch's AI responses.