GiveRadar Charities API

Detailed charity data

GitHub OpenAPI

Operations 3

GET /charity/{slug}/ Get charity details #
GET /charity/{slug}/financials/ Get financial filings #
GET /charity/{slug}/news/ Get news and sentiment #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/giveradar-com:giveradar-com-charities-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

giveradar-com-charities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: GiveRadar Charities API
  description: 'Access integrity assessments, financial data, officers, and contact information for 7.9 million+ nonprofits across 100+ countries.


    ## Authentication

    All requests require an API key. Get your free key at giveradar.com/api/keys/.


    Pass your key as:

    - **Header:** `Authorization: Bearer gr_your_key_here`

    - **Query param:** `?api_key=gr_your_key_here`


    ## Rate Limits

    | Tier | Requests/day | Price |

    |------|-------------|-------|

    | Free | 10 | $0/month |

    | Pro | 10,000 | $99/month |

    | Enterprise | 100,000 | Custom |'
  version: 1.0.0
  contact:
    name: GiveRadar
    email: info@giveradar.com
    url: https://giveradar.com
  license:
    name: Proprietary
    url: https://giveradar.com/terms/
  termsOfService: https://giveradar.com/terms/
servers:
- url: https://giveradar.com/api/v1
  description: Production
security:
- bearerAuth: []
- apiKeyQuery: []
tags:
- name: Charities
  description: Detailed charity data
paths:
  /charity/{slug}/:
    get:
      summary: Get charity details
      description: Get full charity profile including financials, officers, red flags, and review summary.
      operationId: getCharity
      tags:
      - Charities
      parameters:
      - name: slug
        in: path
        required: true
        description: Charity URL slug
        schema:
          type: string
        example: american-national-red-cross
      responses:
        '200':
          description: Full charity details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CharityDetail'
        '404':
          description: Charity not found
  /charity/{slug}/financials/:
    get:
      summary: Get financial filings
      description: Get up to 10 years of financial filing history plus spending breakdown and executive compensation.
      operationId: getCharityFinancials
      tags:
      - Charities
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Financial data
          content:
            application/json:
              schema:
                type: object
                properties:
                  filings:
                    type: array
                    items:
                      $ref: '#/components/schemas/Filing'
                  spending_breakdown:
                    type: object
                    properties:
                      program_spend_pct:
                        type: number
                      admin_spend_pct:
                        type: number
                      annual_expenses:
                        type: integer
                      annual_revenue:
                        type: integer
                  executive_compensation:
                    type: object
                    properties:
                      name:
                        type: string
                      title:
                        type: string
                      compensation:
                        type: integer
  /charity/{slug}/news/:
    get:
      summary: Get news and sentiment
      description: Get recent news articles and average sentiment score for a charity.
      operationId: getCharityNews
      tags:
      - Charities
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: News articles and sentiment
          content:
            application/json:
              schema:
                type: object
                properties:
                  articles:
                    type: array
                    items:
                      $ref: '#/components/schemas/NewsArticle'
                  article_count:
                    type: integer
                  average_tone:
                    type: number
                    nullable: true
components:
  schemas:
    NewsArticle:
      type: object
      properties:
        title:
          type: string
        url:
          type: string
        source_domain:
          type: string
        tone:
          type: number
          nullable: true
        published_at:
          type: string
          format: date-time
    Filing:
      type: object
      properties:
        fiscal_year:
          type: integer
          example: 2023
        total_revenue:
          type: integer
          example: 3200000000
        total_expenses:
          type: integer
          example: 2900000000
        program_expenses:
          type: integer
          nullable: true
        admin_expenses:
          type: integer
          nullable: true
        fundraising_expenses:
          type: integer
          nullable: true
        total_assets:
          type: integer
          nullable: true
        total_liabilities:
          type: integer
          nullable: true
        source:
          type: string
          example: irs_990
    RedFlag:
      type: object
      properties:
        flag_type:
          type: string
          example: high_exec_pay
        severity:
          type: string
          enum:
          - warning
          - critical
        description:
          type: string
        active:
          type: boolean
    Source:
      type: object
      properties:
        section:
          type: string
          example: Financial filings
        name:
          type: string
          example: IRS Form 990 filings
        url:
          type: string
          nullable: true
          example: https://www.irs.gov/forms-pubs/about-form-990
        as_of:
          type: string
          format: date
          nullable: true
          example: '2026-06-05'
        note:
          type: string
          nullable: true
          example: Fiscal year 2025 most recent on file.
    CharityDetail:
      type: object
      properties:
        id:
          type: string
          format: uuid
        slug:
          type: string
        name:
          type: string
        country_code:
          type: string
        description:
          type: string
          nullable: true
        category:
          type: string
          nullable: true
        founded_year:
          type: integer
          nullable: true
        website:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state_province:
          type: string
          nullable: true
        ein:
          type: string
          nullable: true
        uk_charity_number:
          type: string
          nullable: true
        registration_number:
          type: string
          nullable: true
        annual_revenue:
          type: integer
          nullable: true
        annual_expenses:
          type: integer
          nullable: true
        program_expenses:
          type: integer
          nullable: true
        admin_expenses:
          type: integer
          nullable: true
        fundraising_expenses:
          type: integer
          nullable: true
        overhead_ratio:
          type: number
          nullable: true
        program_spend_pct:
          type: number
          nullable: true
        top_exec_name:
          type: string
          nullable: true
          description: Chief executive (CEO, executive director or president) from the latest filing. Name, title and compensation always describe the same person. Pro only.
        top_exec_title:
          type: string
          nullable: true
          description: Title of top_exec_name as filed. Pro only.
        top_exec_compensation:
          type: integer
          nullable: true
          description: Compensation of top_exec_name from the filing organization, in the charity's currency. Pro only.
        employee_count:
          type: integer
          nullable: true
        email:
          type: string
          nullable: true
        phone:
          type: string
          nullable: true
        address:
          type: string
          nullable: true
        donation_url:
          type: string
          nullable: true
        mission_statement:
          type: string
          nullable: true
        logo_url:
          type: string
          nullable: true
        twitter_url:
          type: string
          nullable: true
        facebook_url:
          type: string
          nullable: true
        instagram_url:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
        youtube_url:
          type: string
          nullable: true
        trust_score:
          type: integer
          nullable: true
        data_completeness:
          type: integer
        verified:
          type: boolean
        cause_tags:
          type: array
          items:
            type: string
        operating_countries:
          type: array
          items:
            type: string
        sdg_goals:
          type: array
          items:
            type: string
        data_sources:
          type: array
          deprecated: true
          nullable: true
          description: Deprecated since 2026-10-21, removed in a future release. Source keys of publicly named sources only (internal pipeline tags are no longer included). Use `sources` instead. Pro only.
          items:
            type: string
        sources:
          type: array
          nullable: true
          description: Where each part of the record comes from, the same list as the Sources tab on the charity page. Pro only.
          items:
            $ref: '#/components/schemas/Source'
        last_updated:
          type: string
          format: date-time
        recent_filings:
          type: array
          items:
            $ref: '#/components/schemas/Filing'
        officers:
          type: array
          description: One row per person per fiscal year, latest year first, rows without a fiscal year last, at most 50 rows. Pro only (empty on the free tier).
          items:
            $ref: '#/components/schemas/Officer'
        officers_total:
          type: integer
          nullable: true
          description: Number of distinct people on record (not rows). Pro only.
        red_flags:
          type: array
          items:
            $ref: '#/components/schemas/RedFlag'
        review_summary:
          $ref: '#/components/schemas/ReviewSummary'
    ReviewSummary:
      type: object
      properties:
        count:
          type: integer
          example: 24
        avg_rating:
          type: number
          nullable: true
          example: 4.2
    Officer:
      type: object
      properties:
        name:
          type: string
          example: Jane Doe
        title:
          type: string
          example: President & CEO
        compensation:
          type: integer
          nullable: true
          example: 694000
        fiscal_year:
          type: integer
          nullable: true
          description: Fiscal year of the filing that lists this person; null for older records whose year is unknown.
          example: 2023
        former:
          type: boolean
          description: Listed in that filing as a former officer, director or trustee.
          example: false
        source:
          type: string
          example: irs_990
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API key as Bearer token: `Authorization: Bearer gr_xxxxx`'
    apiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: 'API key as query parameter: `?api_key=gr_xxxxx`'