---
title: "Referee eligibility"
method: POST
path: "/api/merchant/v2/referee/eligibility"
tags: ["Referee"]
---

# Referee eligibility

`POST /api/merchant/v2/referee/eligibility`

Mark all customers matching the given identifiers as eligible for a reward - i.e. they've completed all necessary steps in order to be given a reward. For instance, this could be keeping a product for a certain amount of time, completing their first month with a subscription or completing transferring provider for a utility.

Only customers who are eligible for a reward will be marked as eligible. Any other customers included (e.g. customers who were not referred by a friend or those who do not require approval) will be ignored and discarded.

Customers who require approval because they are suspected of gaming the program will not be marked as eligible. You can approve the customers in the Merchant Portal.

We strongly suggest you pass us _all_ customers who complete the eligibility criteria - as you may not know who was introduced by a friend. We will discard any customers details who are not eligible.

Eligibility is completed on a queue. It may take some time for the customers to be marked as eligible. Approximate time to mark someone as eligible is normally under < 5 minutes, but can be several hours in some cases.

Customers who we were able to queue will be returned in the `accepted` array. Customers who we do not hold a record of or cannot find will be returned in the `errors` array.

You may send 100 customers per request.

**Scopes:** `customers:write`

**Rate limits:** 300 requests per 5 minutes. Shared across all 'referee' endpoints.

## Request body

- CustomerEmailIdentifierCollectionInput — A collection of customer email addresses.
  - `identifiers` CustomerEmailIdentifier[], required — Maximum of 100 identifiers.
    - `type` 'email', required — The type of identifier.
    - `value` string

## Response `202`

All identifiers that were queued to be marked as eligible.

- BulkCustomerResponse — A collection of customer identifiers which were accepted, or resulted in an error.
  - `accepted` CustomerIdentifierInterface2[] — All the identifiers that were accepted.
    - union
      - CustomerEmailIdentifier2
        - `type` 'email', required — The type of identifier.
        - `value` string
      - CustomerIdIdentifier2
        - `type` 'customerId', required — The type of identifier.
        - `value` string, required
  - `errors` CustomerErrorPayloadInterface2[] — All the identifiers which resulted in errors.
    - `type` 'email' | 'customerId'
    - `value` string
    - `reason` 'notFound'

## Other responses

- `401` — Required scopes are missing.
- `404` — No customers matched the identifiers.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.net/mention-me/apis/auth-api.md) · [All operations](https://skmtc.net/mention-me/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mention-me/auth-api/versions/cdad84f071bd/schema)