This is a Beta API and is subject to change.


Unlike Refersion’s REST API which has a variety of endpoints, the GraphQL API has a single endpoint:

POST https://graphql.refersion.com


The GraphQL API requires an access token for making authenticated requests.

Getting your access token

Refersion merchants can obtain an access token by logging into your Refersion account and navigating to Account > Settings > Refersion API > GraphQL.

If you are a Refersion Marketplace user you can follow these instructions to generate a GraphQL token.

Making your first query

You can access the GraphQL API endpoint using cURL or any other HTTP client. For the following test example, make sure to replace <ACCESS_TOKEN> with the token you obtained from the Authentication section.


To make a query using curl, send a POST request with your query as the JSON payload.

curl -X POST \
"https://graphql.refersion.com" \
-H "X-Refersion-Key: <YOUR_ACCESS_TOKEN>" \
-H "Content-Type: application/json" \

Example Query

    "query": "{  
        offers {