Versions Compared

Version Old Version 1 New Version Current
Changes made by

Raiko Pajur

Dimitar Peev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleProduction

https://production.revshare.api.geniussports.com/api/uploads/json

Mandatory query parameters

Parameter

Description

Value type

uploaded_by

Email address of the uploading client’s contact

string <email>

Example:uploaded_by=test.revshare.customer1@geniussports.com

account_id

Account ID of the client

number

Example: account_id=1000004

start_date

Start date of the uploaded data

string^\d\d\d\d-\d\d-\d\d$ (YYYY-MM-DD)

Example: start_date=2022-09-01

end_date

End date of the uploaded data

string^\d\d\d\d-\d\d-\d\d$ (YYYY-MM-DD)

Example: end_date=2022-09-30

provided_for

RevShare or NFL upload

string

Enum: revshare nfl

template

Account or Brand level NFL or Inplay (RevShare) upload

string

Enum: nfl_account nfl_brand inplay_account inplay_brand

reference

Automated upload reference number or identifier.

string

Example: reference=API-Upload-Oct-22

This reference appears on emails sent to the admin contact of the client

token

Client's Authentication Token

string

Example: token=6cfc21c0-7e5b-11ed-a1eb-0242ac121112

...

Expand
titleProduction

https://production.revshare.api.geniussports.com/api/uploads/{upload_uuid}

Mandatory query parameters

Parameter

Description

Value type

token

Client's Authentication Token

string

Example: token=6cfc21c0-7e5b-11ed-a1eb-0242ac121112

...

Expand
titleExample response
Code Block
{
   "result":"success",
   "data":{
      "upload_id":"5xxxxxx3-8xx9-4xx6-8xx4-exxxxxxxxx17",
      "upload_ref":"API upload NFL Account '22 Game Week 16 test 6 April",
      "upload_valid":true,
      "import_status":"partially_validated",
      "imported_records":15,
      "results":{
         "valid_records":14,
         "failed_records":1,
         "ignored_records":0,
         "number_of_errors":2,
         "errors":[
            {
               "code":"BAD_LB_PCT_OF_TS",
               "name":"Land-based % of Total Stake is out of range.",
               "count":1
            },
            {
               "code":"BAD_OL_PCT_OF_TS",
               "name":"Online % of Total Stake is out of range.",
               "count":1
            }
         ]
      }
   }
}

Downloading Usage

Method: GET

Returns a full set of usage data from the Genius Sports systems for the specific customer account. All data is returned in B2B upload format (Brands included).

API Endpoints

Expand
titleUAT

https://uat.revshare.api.geniussports.com/api/account/{account_id}/usage

Expand
titleProduction

https://production.revshare.api.geniussports.com/api/account/{account_id}/usage

Mandatory query parameters

Parameter

Description

Value type

year

The year for the requested usage data

string

Example: 2023

month

The month for the requested usage data

string

Example: 2

limit

A limit for the result size. Defaults to 1000. Requesting more than a few thousand rows is not advised as the responses will get slower.

integer

Example: 1000

token

Client's Authentication Token

string

Example: token=6cfc21c0-7e5b-11ed-a1eb-0242ac121112

Path parameters

Parameter

Description

Value type

{account_id}

The Account ID of the customer

string

Example: 121121

Response

The API returns a 200 response when the usage data was successfully generated. The usage data is passed as a JSON in the body of the response. A “next” link is returned as part of the response that can be followed for the next page of results if multiple pages or results need to be served.

NB: usage_gameweek is only returned for NFL fixtures.

Expand
titleExample success body
Code Block
languagejson
{
    "result": "success",
    "page": 1,
    "next": "/api/account/121121/usage?year=2023&month=1&page=2&limit=1000&token=6cfc21c0-7e5b-11ed-a1eb-0242ac121112",
    "data": [
        {
            "brand_id": 100111,
            "brand_name": "BrandName",
            "usage_type": "InPlay",
            "usage_year": "2023",
            "usage_month": "1",
            "usage_gameweek": null,
            "sport_id": 10,
            "sport_name": "Football",
            "competition_id": 11968,
            "competition_name": "Argentina Torneo Regional Amateur",
            "fixture_id": 9943324,
            "fixture_name": "Atlético Uruguay v 9 de Julio Rafaela",
            "fixture_date": "29-JAN-2023",
            "fixture_time": "23:30"
        },
        {
            "brand_id": 100112,
            "brand_name": "BrandName2",
            "usage_type": "InPlay",
            "usage_year": "2023",
            "usage_month": "1",
            "usage_gameweek": null,
            "sport_id": 10,
            "sport_name": "Football",
            "competition_id": 1547,
            "competition_name": "Brazil Pernambucano",
            "fixture_id": 9895576,
            "fixture_name": "Salgueiro AC v Central SC",
            "fixture_date": "28-JAN-2023",
            "fixture_time": "23:00"
        },
        {
            "brand_id": 100113,
            "brand_name": "BrandName3",
            "usage_type": "NFL",
            "usage_year": "2023",
            "usage_month": "1",
            "usage_gameweek": 22,
            "sport_id": 17,
            "sport_name": "American Football",
            "competition_id": 296,
            "competition_name": "NFL",
            "fixture_id": 9250368,
            "fixture_name": "Denver Broncos v Los Angeles Chargers",
            "fixture_date": "08-JAN-2023",
            "fixture_time": "21:25"
        },
        {
          "..." : "..."
        },
    ]
}