Skip to main content
GET
/
impact
/
stories
/
{ein}
Get Stories for a Nonprofit
curl --request GET \
  --url https://api.givingcompass.org/insights/impact/stories/{ein} \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "ein": "<string>",
      "organization_name": "<string>",
      "story_title": "<string>",
      "story_id": "<string>",
      "emotional_hook": "<string>",
      "full_quote": "<string>",
      "quote_attribution": "<string>",
      "protagonist": "<string>",
      "before_state": "<string>",
      "transformation_moment": "<string>",
      "after_state": "<string>",
      "time_to_impact": "<string>",
      "obstacles_overcome": [
        "<string>"
      ],
      "metrics": [
        {
          "metric_id": "<string>",
          "metric_text": "<string>",
          "metric_type": "<string>",
          "metric_value": 123,
          "unit": "<string>",
          "geo_impact": "<string>",
          "time_aggregation": "<string>"
        }
      ],
      "ripple_effect": "<string>",
      "call_to_action": "<string>",
      "story_category": "<string>",
      "identity_alignment": "<string>",
      "date_extracted": "<string>",
      "source_url": "<string>",
      "report_year": 123,
      "power_score": 123,
      "confidence_score": 123
    }
  ],
  "total": 123,
  "page": 123,
  "size": 123
}

Authorizations

X-API-Key
string
header
required

Add a header [X-API-Key] with the token

Path Parameters

ein
string
required

The unique 9 digit identifier assigned to businesses by the IRS

Required string length: 9

Query Parameters

min_power_score
number | null
page
integer
default:1

Page number

Required range: x >= 1
size
integer
default:20

Page size

Required range: 1 <= x <= 100

Response

Successful Response

items
InsightsImpactStoryResponse · object[]
required
total
integer
required
page
integer
required
size
integer
required