Overview

Deprecated for merchants

The GraphQL API is deprecated for merchants. Merchants should build new integrations on the current version of the Refersion REST API (v2026-08) — see the API Reference. GraphQL for marketplace affiliates is not affected.

What is GraphQL?

GraphQL is a new way to think about building and querying APIs. Rather than construct several REST requests to pull data that you're interested in, you can fetch all the information you need in a single call. GraphQL allows you specify exactly which fields you need, making data querying more flexible and efficient than traditional REST APIs.

Example request and response:

GraphQL is, above all, a querying language, and the format of the query you send matches the data you receive. The language has a schema that strongly ties the exchange between client and server.

We built GraphQL API to supplement our existing REST API, giving you more flexibility to get exactly the data you need.

Additional Resources

Below is some optional reading material that might help you go deeper into the GraphQL ecosystem:

• GraphQL Specification
• Introduction to GraphQL
• The Fullstack Tutorial for GraphQL
• List of GraphQL Tools

Related

• Getting Started — the endpoint, authentication, and your first query.
• Schema Reference — every query, type, field and argument the API exposes.
• Filtering and Sorting — how arguments behave across every query.
• Order Tracking — attribute sales to affiliates by reporting orders to Refersion.
• Webhooks — receive real-time event notifications instead of polling.
• API Reference — how to authenticate, and every endpoint the Refersion REST API exposes.