---
title: "Accept referral offer (GET)"
method: GET
path: "/loyalty/cp/api/referral-rules/accept-offer"
tags: ["Referrals"]
---

# Accept referral offer (GET)

`GET /loyalty/cp/api/referral-rules/accept-offer`

## Request

- Base URL: `https://your-store.myshopify.com/apps`
- URL: `https://your-store.myshopify.com/apps/loyalty/cp/api/referral-rules/accept-offer`
- Auth: none declared

Accepts a referral offer using the referral token and email address via query parameters. This is a convenience endpoint that provides the same functionality as the POST version but via GET request. Useful for simple referral link implementations where query parameters are easier to construct. Creates a new customer referral record and may generate a welcome discount code for the referee.

## Query parameters

- `token` string, required
- `email` string, required

## Response `201`

Referral offer accepted successfully

- ReferralAcceptResponse
  - `discountCode` string
  - `errorKey` string
  - `existingCustomer` boolean
  - `id` integer
  - `message` string
  - `status` 'SUCCESS' | 'FAILED'

## Other responses

- `400`: Invalid token or email, referral already accepted, or referral program not available

## Changes

- **2026-10-06** `eace591c6962`: 2 info
  - added the optional property `existingCustomer` to the response with the `201` status
  - added the optional property `existingCustomer` to the response with the `400` status
- **2026-09-05** `0f423f0dce11`: 2 info
  - added the optional property `errorKey` to the response with the `201` status
  - added the optional property `errorKey` to the response with the `400` status

[Operation history](https://skmtc.dev/appstle/apis/storefront-apis/changes/loyalty/cp/api/referral-rules/accept-offer/get.md)

---

[API](https://skmtc.dev/appstle/apis/storefront-apis.md) - [All operations](https://skmtc.dev/appstle/apis/storefront-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/appstle/apis/storefront-apis/revisions/9f59d178ff71?raw)