Intro
Overview of the Ballpark GraphQL API, endpoints and capabilities
We are delighted to introduce you to the Ballpark Developer Platform. Our GraphQL API provides a robust, flexible, and efficient way to build applications and integrations on top of the Ballpark research ecosystem. With it, you can automate workflows, extend platform capabilities, and integrate Ballpark into your existing tools—all without relying exclusively on ballparkhq.com.
The Ballpark API exposes a broad range of functionality, including the ability to create studies, manage studies, organise users, and interact with platform resources programmatically. Whether you are building internal dashboards, productivity bots, third-party integrations, or entirely new applications, the API is designed to support your requirements at scale.
Why GraphQL?
Ballpark’s API is built on GraphQL, a query language for APIs that provides clients with precise control over the data returned by the server. Unlike traditional REST endpoints, GraphQL allows you to request exactly the fields you need, improving performance and reducing over-fetching.
GraphQL operations fall into two categories:
Queries — read-only operations that return data without side effects.
Mutations — operations that modify data on the server and also return a result.
For example, the following query retrieves the current user’s email address:
Here, the query starts at the root node (query
) and requests the email
field from the user
node. You could just as easily request additional fields, such as associated projects or teams, depending on your requirements.
For a comprehensive introduction to GraphQL, refer to the official documentation at graphql.org/learn.
Account Requirements
To access the Ballpark API, you will need a valid Ballpark account. You can sign up for a free account to get started immediately.
Alternatively to build an integration of a paid Enterprise workspace please contact your customer success representative to gain access to the workspace to start building off the API for your team.
Getting Started
The best way to begin is with the Get Started guide or by following our step-by-step tutorials. Once you are familiar with the basics, you can explore the full schema and experiment interactively using our web-based IDE.