Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.giveready.org/llms.txt

Use this file to discover all available pages before exploring further.

Nonprofits

List All Nonprofits

GET /api/nonprofits Returns all verified nonprofits in the directory, paginated.

Query Parameters

ParameterTypeRequiredDescription
limitintegerNoResults per page (default: 20, max: 100)
offsetintegerNoPagination offset

Example

curl "https://giveready.org/api/nonprofits?limit=10"

Get Nonprofit Profile

GET /api/nonprofits/{slug} Returns the full profile for a single nonprofit, including programmes, impact metrics, registrations, and wallet address.

Path Parameters

ParameterTypeDescription
slugstringThe nonprofit’s URL slug (e.g., city-kids-surfing)

Example Request

curl "https://giveready.org/api/nonprofits/city-kids-surfing"

Example Response

{
  "id": "city-kids-surfing",
  "slug": "city-kids-surfing",
  "name": "City Kids Surfing",
  "tagline": "Getting city kids into the ocean",
  "mission": "City Kids Surfing takes young people from urban environments into the sea — using surfing as a tool for building confidence, resilience, and mental wellbeing.",
  "description": "Founded in 2017 by Joe Taylor, City Kids Surfing runs an annual surf trip and year-round mentoring programme for around 30 young people from urban communities...",
  "website": "https://getcitykidssurfing.com",
  "country": "United Kingdom",
  "city": "London",
  "region": "England",
  "founded_year": 2017,
  "annual_budget_usd": 50000,
  "team_size": 5,
  "beneficiaries_per_year": 30,
  "verified": true,
  "causes": [
    {"id": "youth-empowerment", "name": "Youth Empowerment"},
    {"id": "mental-health", "name": "Mental Health"},
    {"id": "surf-therapy", "name": "Surf Therapy"}
  ],
  "programs": [
    {
      "name": "Annual Surf Trip",
      "description": "Multi-day residential surf trip taking young people from the city to the coast.",
      "beneficiaries_per_year": 30,
      "location": "UK coast"
    },
    {
      "name": "Mentoring Programme",
      "description": "Year-round one-to-one mentoring for young people.",
      "beneficiaries_per_year": 30,
      "location": "London"
    }
  ],
  "impact_metrics": [
    {"name": "Young people supported annually", "value": "30", "unit": "young people", "period": "annual"},
    {"name": "Years operating", "value": "8", "unit": "years", "period": "cumulative"}
  ],
  "registrations": [
    {"country": "United Kingdom", "type": "Registered Charity", "registration_number": "1182899"}
  ],
  "donate_url": "https://giveready.org/donate/city-kids-surfing"
}

Response Fields

FieldTypeDescription
idstringUnique identifier
slugstringURL-friendly identifier
namestringOrganisation name
taglinestringShort description
missionstringMission statement
descriptionstringDetailed description
websitestringOrganisation website
countrystringCountry of operation
causesarrayAssociated cause areas
programsarrayActive programmes with beneficiary counts
impact_metricsarrayQuantified impact data
registrationsarrayOfficial registrations with numbers
usdc_walletstringSolana USDC wallet address (if set)
verifiedbooleanWhether the profile has been verified
donate_urlstringDirect donation page URL