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.

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 all fundraisers associated with your charity. The charity.donations query allows you to retrieve all donations of all fundraisers associated with your charity.

Example use cases

charity.fundraisers

To query all fundraisers associated with your charity, use charity.fundraisers.

Query example:

query {
  charity(slug: "YOUR_CHARITY_SLUG") {
    fundraisers {
      edges {
       node {
         title
         description
       }
      }
    }
  }
}

Response:

{
  "data": {
    "charity": {
      "fundraisers": {
        "edges": [
          {
            "node": {
              "title": "Charity Fundraiser 1",
              "description": "A fundraiser description for a test campaign"
            }
          },
          {
            "node": {
              "title": "Charity Fundraiser 2",
              "description": "Another description for a test campaign"
            }
          }
        ]
      }
    }
  }
} 

charity.donations

To query all donations associated with your charity, use charity.donations. Use pagination and hasNextPage to determine when you’ve reached the end of a connection. You can control the page size with first and last. Lets retrieve the first 5:

Query example:

query {
  charity(slug: "YOUR_CHARITY_SLUG") {
    donations(first: 5) {
      pageInfo {
        hasNextPage
        hasPreviousPage
        startCursor
      }
      edges {
       node {
         name
         amount {
          currencyCode
          amount
        }
        fundraiser {
          title
          fundId
        }
       }
      }
    }
  }
}

Response:

{
  "data": {
    "charity": {
      "donations": {
        "pageInfo": {
          "hasNextPage": true,
          "hasPreviousPage": false,
          "startCursor": "RG9uYXRpb246aWQ6NzYxNTg1NjIz"
        },
        "edges": [
          {
            "node": {
              "name": "Archer Woolery",
              "amount": {
                "currencyCode": "USD",
                "amount": 5
              },
              "fundraiser": {
                "title": "Adyen test campaign",
                "fundId": "33760977"
              }
            }
          },
          {
            "node": {
              "name": "Archer Woolery",
              "amount": {
                "currencyCode": "USD",
                "amount": 5
              },
              "fundraiser": {
                "title": "Adyen test campaign",
                "fundId": "33760977"
              }
            }
          },
          {
            "node": {
              "name": "Archer Woolery",
              "amount": {
                "currencyCode": "USD",
                "amount": 5
              },
              "fundraiser": {
                "title": "Adyen test campaign",
                "fundId": "33760977"
              }
            }
          },
          {
            "node": {
              "name": "Product Testing",
              "amount": {
                "currencyCode": "USD",
                "amount": 7
              },
              "fundraiser": {
                "title": "Adyen test campaign",
                "fundId": "33760977"
              }
            }
          },
          {
            "node": {
              "name": "Ksenia Cat",
              "amount": {
                "currencyCode": "USD",
                "amount": 7
              },
              "fundraiser": {
                "title": "Adyen test campaign",
                "fundId": "33760977"
              }
            }
          }
        ]
      }
    }
  }
}