Override

Tier overrides let customer service agents manually place users into tiers they haven't yet earned with tier points. This bypasses standard tier rules and is reflected in the public_facing_tier and tier_overrides sections of the lookup response schema.

We currently support two types of overrides: status_match and placement. For your reference, you can see sample lookup responses below for both types of overrides as well as an explanation of the data fields in the response.

For public_facing_tier, we will always choose the outcome which is best for the customer.

Preconditions

  • This API requires a server-to-server auth token:

  • You can generate a server-to-server token using the S2S Auth API

Required Scopes

tier_points:override

Request

URL

/v2/tier-points/override

Method

POST

Headers

Name
Required
Description

Authorization

true

a s2s Bearer token for accessing the API

Request Object

  • You may submit a maximum of 200 transactions in the payload

  • You can overwrite existing campaigns for a user.

    • For overwriting a user's status match campaign, if the start date supplied in the new request is the same day as the existing campaign, their points towards the status match target will not be reset.

    • If the new campaign has a different start date from the existing status match campaign, their points for the trial target will be reset.

Field
Type
Required
Description

overrides

array

true

List of account-level override instructions.

overrides[].account_tenant_fanid

string (UUID)

true

Tenant-scoped FanID of the customer receiving the override(s).

overrides[].tier_overrides

array

true

One or more tier override entries to apply for the given account. While you can provide multiple override campaigns for a single user, the latest entity will be used for a given override type.

overrides[].tier_overrides[].campaign

string

true

Campaign or program identifier for the override (e.g., name/code used for tracking). These campaigns are pre-defined based on business needs.

overrides[].tier_overrides[].start

string (datetime, RFC 3339)

false

Start timestamp when the override becomes effective. Defaults to the current time if omitted. Format: ISO 8601

overrides[].tier_overrides[].note

string

false

Free-form notes associated with this override.

overrides[].tier_overrides[].extra_data

object

false

Additional metadata for the override (key–value pairs).

Example

View Example JSON Payload
{
  "overrides": [
    {
      "account_tenant_fanid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "tier_overrides": [
        {
          "campaign": "SomeCompetitor-Gold", // preconfigured status match for some competitor's gold users; they become gold in FanaticsONE
          "start": "2025-11-31T23:59:59Z",
          "note": "MVP Launch mass statusmatch",
          "extra_data": {}
        },
        ...
    },
    {
      "account_tenant_fanid": "12345678-1234-1234-dddd-eeeeeeeeeeee",
      "tier_overrides": [
        {
          "campaign": "Placement-Platinum" 
        },
        ...
    },
    ...
  ]
}

Response

Please note: in most cases this endpoint will return 201 Status Created, but there may be issues with individual transactions. Please inspect the response body for an "ok" or "nok" for each transaction's status.

Response Object

Field
Type
Description

tier_overrides

array

List of transaction response objects returned by the bulk request.

tier_overrides[].account_tenant_fanid

string (UUID)

Unique FanID for the customer’s account (tenant-specific).

tier_overrides[].details

string

Additional information about the transaction result (e.g., "created", "overwritten").

tier_overrides[].campaign

string

Campaign or program identifier for the override (e.g., name/code used for tracking) that was passed in the request. These campaigns are pre-defined based on business needs.

tier_overrides[].result

string

Outcome of the transaction (e.g., "ok", "nok").

Examples

View Example Normal JSON Response
{
    "tier_overrides": [
      {
        "account_tenant_fanid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "campaign": "DraftKings-Gold",  
        "details": "created", // if ok, created/overwriten
        "result": "ok"
      },
      {
        "account_tenant_fanid": "12345678-1234-1234-dddd-eeeeeeeeeeee",
        "campaign": "StatusMatch-Platinum",  
        "details": "overwritten", // if ok, created/overwriten
        "result": "ok"
      },
      ...
    ]
}
View Example JSON Response With Transaction-level Issue ("nok")
{
    "tier_overrides": [
      {
        "account_tenant_fanid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "campaign": "Not-A-Real-Campaign",  
        "details": "invalid campaign name", 
        "result": "nok"
      },
      ...
    ]
}

Error Response Data

Error Response Wrapper

Property
Description

errors

array containing error response entries

rc

randomly generated identifier allowing call tracing within Fanatics. When reporting repeated errors or coordinating issue resolution with Fanatics, this value will assist in diagnosing any issues.

timestamp

processing timestamp in Zulu time of Fanatics API server using ISO 8601 format (https://datatracker.ietf.org/doc/html/rfc3339#section-5.6). Useful for issue resolution with Fanatics as log data is partitioned by date and time.

Error Response Wrapper -> Errors -> item

Property
Description

code

Fanatics error code for the specific error; this is generally not an http status code. Code values are generally stable for the API.

message

additional textual information describing the error. This is useful in debugging, but should not be checked programmatically

Full Spec

override tier points

post

override tier points. Requires the tier_points:override permission.

Header parameters
AuthorizationstringRequired

Server Bearer Token

Body
Responses
201

Tier Points Override Response

application/json
post
POST /v2/tier-points/override HTTP/1.1
Host: 
Authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 167

{
  "overrides": [
    {
      "account_tenant_fanid": "text",
      "tier_overrides": [
        {
          "campaign": "text",
          "extra_data": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "note": "text",
          "start": "text"
        }
      ]
    }
  ]
}
{
  "tier_overrides": [
    {
      "account_tenant_fanid": "text",
      "campaign": "text",
      "details": "text",
      "result": "ok/nok"
    }
  ]
}
PreviousLedgerNextAccounts

Last updated