Table of Contents

Fixture Official

What is Fixture Official? The Fixture Official is the Official or Assistant Referee of the Fixture. It is created by associating a Person directly to the Fixture

When to use

If the real-life referees for the Fixture are available they can be proposed to the Fixture.

How to use

In order to create Fixture Official First the Person and the Fixture must exist or be created. And then the Fixture Official can be proposed or requested on endpoint /v2/fixtures/{gss_fixture_id}/officials of Fixtures API v2

Example workflow

1. GET GSS Fixtures from Fixtures API v2

   curl --location --request GET 'https://ci.fixtures.api.geniussports.com/v2/fixtures' \ --header 'x-api-key: <<api_key>>' \ --header 'Content-Type: application/json' \ --header 'Authorization: <<id_token>>' \ --data-raw ''

   Successful response would be with status code 200 and JSON data in format:

   { "page": 0, "pageSize": 0, "totalItems": 0, "items": [ { "metadataProperties": [ // The sport specific rules set to the fixture both derived, overriden or set to the current fixture only { "name": "string", "value": "string" } ], "id": 0, // GSS Fixture Id "createdOn": "2021-11-29T12:08:59.387Z", "modifiedOn": "2021-11-29T12:08:59.387Z", "startDate": "2021-11-29T12:08:59.387Z", // Start date of the fixture "name": "string", "season": { "Id": 0, // GSS Season Id to which the fixture is associated "Name": "string", "Ref": "/seasons/{Id}" }, "eventStatusType": "string", // Whether it is finished, inprogress or notstarted. "locality": { "Id": 0, // GSS Locality Id (if set) where the fixture will be played "Name": "string", "ref": "/localities/{id}" // Endpoint on which the Locality is available }, "timezone": { "Id": 0, // GSS Timezone Id in which the fixture will be played "Name": "string", "Ref": "/timezones/{Id}" }, "venue": { "Id": 0, // GSS Venue Id on which the fixture will be played "Name": "string", "Ref": "/venues/{Id}" }, "sport": { "Id": 0, // GSS Sport Id for which the fixture will be played "Name": "string", "ref": "/sports/{id}" // Endpoint on which Sport is available }, "competition": { "Id": 0, // GSS Competition Id to which the fixture is associated "Name": "string", "Ref": "/competitions/{Id}" }, "round": { "Id": 0, // GSS Round Id (if set) to which the fixture is associated "Name": "string", "Ref": "/rounds/{Id}" }, "genderType": "string", "competitors": [ { "id": 0, // GSS Competitor Id "name": "string", // GSS Competitor Name "competitorType": "string", // GSS Competitor Type "ref": "/competitors/{competitorType}/{id}" } ] } ], "self": "string", "previous": "string", "next": "string", "first": "string", "last": "string" }

    

2. Get Fixture Officials from Fixtures API v2

   curl --location --request GET 'https://ci.fixtures.api.geniussports.com/v2/fixtures/{gss_fixtures_id}/officials' \ --header 'x-api-key: <<api_key>>' \ --header 'Content-Type: application/json' \ --header 'Authorization: <<id_token>>' \ --data-raw ''

   Successful response would be with status code 200 and JSON data in format:

Read Data Points

Create/ Update Data Points

Validations