GoFundMe GraphQL API

Getting Started

Welcome to our platform! This guide will walk you through creating an API key and making your first request to the GoFundMe GraphQL API.

Step 1: Log in and find the API Keys section

1. Go to the Fundraisers page.
2. Under your charity activity, locate the API Keys section.

Step 2: Create an API key

1. Take note of your partner code and charity slug — you’ll need it later.
2. Create a new API key and save it somewhere secure (for example, in a password manager). You can only view it once.

Step 3: Set up your request

1. Open Postman (or your preferred tool for sending POST requests).
2. Set the request type to POST.
3. Use the URL https://graphql.gofundme.com/graphql.
4. Add headers:
   • x-partner-code: Your partner code
   • x-api-key: Your API key
5. Add your GraphQL query as the POST body (see example query below)
6. Send the request

Curl request

curl --location 'https://graphql.gofundme.com/graphql' \
--header 'x-partner-code: YOUR_PARTNER_CODE' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{"query":"query { charity(slug: 'YOUR_CHARITY_SLUG') { id name state zipCode }}"}'

GraphQL query

charity(slug: "YOUR_CHARITY_SLUG") {
    id
    name
    state
    zipCode
}

If you provided your key correctly, you should get back a response containing your charity information.

{
  "data": {
    "charity": {
      "id": "1234",
      "name": "My charity name",
      "state": "XY",
      "zipCode": "12345"
    }
  }
}

Next steps

Congratulations! You have successfully completed the getting started guide. Here are some next steps to explore:

• Explore additional GraphQL queries such as https://charitydocs.gofundme.com/#query-charity
• Integrate the API into your application.

Query Requirements

All GraphQL queries and mutations sent to the GoFundMe API MUST follow these requirements:

1. Use Named Operations

Every query or mutation must have a name. Anonymous operations are not supported.

Do this (named query):

query GetPartnerInfo {
  partner {
    code
    name
  }
}

Don't do this (anonymous query):

query {
  partner {
    code
    name
  }
}

2. Use Variables Instead of Inline Values

Pass dynamic values as variables rather than embedding them directly in the query string.

Do this (parameterized with variables):

query GetFundraiser($slug: ID!) {
  fundraiser(slug: $slug) {
    title
  }
}

With variables passed separately in the request:

{
  "query": "query GetFundraiser($slug: ID!) { fundraiser(slug: $slug) { title } }",
  "variables": { "slug": "my-fundraiser-slug" }
}

Don't do this (inline values):

query GetFundraiser {
  fundraiser(slug: "my-fundraiser-slug") {
    title
  }
}

Retrieving donations and fundraisers

This guide will help you get started with querying data to retrieve all the fundraisers and donations associated with your charity.

How it works

The charity.fundraisers query allows you to retrieve fundraisers associated with your charity. The charity.donations query allows you to retrieve donations across all fundraisers associated with your charity.

A filter with a date range is required on both queries. Queries without a filter are not supported.

Example use cases

charity.fundraisers

Use the filter argument to specify the published date range. You can also control sort order with order (CREATED_AT, AMOUNT, or LAST_DONATION_AT).

Query example — fundraisers published in 2024, most recently donated to first:

query {
  charity(slug: "YOUR_CHARITY_SLUG") {
    fundraisers(
      first: 10
      filter: { dateFrom: "2024-01-01T00:00:00Z", dateTo: "2025-01-01T00:00:00Z" }
      order: LAST_DONATION_AT
    ) {
      pageInfo {
        hasNextPage
        endCursor
      }
      edges {
        node {
          title
          slug
          currentAmount {
            currencyCode
            amount
          }
          donationCount
        }
      }
    }
  }
}

Response:

{
  "data": {
    "charity": {
      "fundraisers": {
        "pageInfo": {
          "hasNextPage": true,
          "endCursor": "RnVuZHJhaXNlcjppZDozNTk4MjM0NQ=="
        },
        "edges": [
          {
            "node": {
              "title": "Help rebuild the community centre",
              "slug": "help-rebuild-the-community-centre",
              "currentAmount": {
                "currencyCode": "USD",
                "amount": 3200
              },
              "donationCount": 47
            }
          }
        ]
      }
    }
  }
}

charity.donations

Use the filter argument to specify the published date range. You can also control sort order with order (CREATED_AT or AMOUNT). Use hasNextPage and endCursor to paginate through results.

Query example — donations from Q1 2024, largest first:

query {
  charity(slug: "YOUR_CHARITY_SLUG") {
    donations(
      first: 10
      filter: { dateFrom: "2024-01-01T00:00:00Z", dateTo: "2024-04-01T00:00:00Z" }
      order: AMOUNT
    ) {
      pageInfo {
        hasNextPage
        endCursor
      }
      edges {
        node {
          name
          amount {
            currencyCode
            amount
          }
          createdAt
          charitySource {
            sourceType
            sourcePage
          }
        }
      }
    }
  }
}

Response:

{
  "data": {
    "charity": {
      "donations": {
        "pageInfo": {
          "hasNextPage": false,
          "endCursor": "RG9uYXRpb246aWQ6NzYxNTg1NjI5"
        },
        "edges": [
          {
            "node": {
              "name": "Jane Smith",
              "amount": {
                "currencyCode": "USD",
                "amount": 500
              },
              "createdAt": "2024-03-15T10:22:00Z",
              "charitySource": {
                "sourceType": "FUNDRAISER",
                "sourcePage": "https://www.gofundme.com/f/help-rebuild-the-community-centre"
              }
            }
          },
          {
            "node": {
              "name": "Anonymous",
              "amount": {
                "currencyCode": "USD",
                "amount": 250
              },
              "createdAt": "2024-02-03T08:45:00Z",
              "charitySource": {
                "sourceType": "DIRECT",
                "sourcePage": "https://www.gofundme.com/charity/example-charity"
              }
            }
          }
        ]
      }
    }
  }
}