The 'validateReferralClaimCode' field is deprecated.

Use the global territories.common.referrals.validateReferralCode query instead.

- Marked as deprecated on 2025-10-20.
- Scheduled for removal on or after 2026-10-20.

Arguments

value : String!


            required

Referral claim code value.

Returns

ReferralClaimCodeType

Referral claim code is a way of claiming promotional benefit coming from the partner-reward referral schemes.

Possible Errors

KT-CT-1113: Disabled GraphQL field requested.
KT-CT-6724: Referral claim code not found.
KT-CT-6726: Referral claim code has already been redeemed.
KT-CT-6727: Referral claim code is not available.
KT-CT-7899: An internal error occurred.

Allowed Viewers

Customer

Partner User

Third party

Rate Limits

Key	Steps
`ip`	['5/m']

Query Complexity

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

Query

query ValidateReferralClaimCode($value: String!) {
  validateReferralClaimCode(value: $value) {
    accountReferral {
      ...ReferralTypeFragment
    }
    createdAt
    id
    isValid
    referralScheme {
      ...ReferralSchemeTypeFragment
    }
    value
  }
}

Variables

{
  "value": "ok-mind-air-woman-yard"
}

Response

{
  "data": {
    "validateReferralClaimCode": {
      "accountReferral": ReferralType,
      "createdAt": "2012-01-19T20:20:22.241856+00:00",
      "id": 36840082,
      "isValid": true,
      "referralScheme": ReferralSchemeType,
      "value": "have-minute-best-generation-offer"
    }
  }
}