How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Genius Sports

Genius Sports Contracts API

The Contracts API from Genius Sports — 10 operation(s) for contracts.

Documentation Provider Profile APIs.io OpenAPI GitHub

Genius Sports Contracts API is one of 31 APIs that Genius Sports publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Contracts. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 13 operations across 10 paths, and defines 24 schemas. It is described by OpenAPI 2.0, at version 2.0.280.

Requests are made against the base URL https://fixtures.api.geniussports.com/v2.

13 operations 10 paths 24 schemas 3 DELETE6 GET1 OPTIONS2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
2.0.280
Base URL
https://fixtures.api.geniussports.com/v2
Authentication
API Key, API Key
Contact
sbonboarding@geniussports.com
License
Apache 2.0
Resource Areas
1

Authentication & Security 2

Genius Sports Contracts API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (Auth0). An API key is passed in the header as x-api-key (api_key).

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 3 DELETE, 6 GET, 1 OPTIONS, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Contracts 13
OPTIONS
/contracts
→ 200
GET
/contracts
Retrieve contracts between person and different types of competitors.
5 params → 200520400500401413403415
POST
/contracts
Create new contract between competitor of any type and person
3 params → 520201400202500404504429
PUT
/contracts
Update existing contract between competitor of any type and person
3 params → 200520400202500404504409
GET
/competitors/doubles/{id}/contracts
Retrieve persons which are part of the doubles partnership by Doubles Partnership ID/s. MAX 200 per page.
6 params → 200520400500401413403415
GET
/competitors/players/{id}/contracts
Retrieve persons which are associated with the current player (e.g. coaches) by Player ID/s. MAX 200 per page.
6 params → 200520400500401413403415
GET
/competitors/teams/{id}/contracts
Retrieve persons which are part of the team (a.k.a. Rosters) or persons which were part of the team by Team ID/s. MAX 200 per page.
6 params → 200520400500401413403415
POST
/contracts/officials
Create new contract between competitor and person who has a team official role
3 params → 520201400202500404504429
DELETE
/contracts/team/{teamId}/person/{personId}
Delete existing contract by team and person Ids
4 params → 200520400202500404504
DELETE
/contracts/team/{teamId}/player/{playerId}
Delete existing contract by team and player Ids
4 params → 200520400202500404504
DELETE
/contracts/{id}
Delete existing contract by id
3 params → 200520400202500404504
GET
/fixtures/{id}/contracts
Retrieve a snapshot of the contracts that were active for the competitors which were part of the fixture when the fixture took place.
6 params → 200520400301500401413403
GET
/persons/{id}/contracts
Retrieve teams/doubles partnerships/players/etc in which the person takes (as coach, player in team, owner etc.) part by Person ID/s. MAX 200 per page.
6 params → 200520400500401413403415

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are ContractResponseModel (14 properties), CompetitorContractResponseModel (13 properties), PersonHALEmbededResponse (10 properties), PersonContractResponseModel (10 properties). Each schema is shown below with its type and property counts.

UpdateContract
object
5 properties 2 required
Error
object
5 properties 3 required
CreatePersonViewModel
object
8 properties 5 required
CompetitorHALEmbededResponse
object
5 properties 4 required
PersonContractResponseModel
object
10 properties 7 required
Empty
object
CompetitorContractResponseModelHATEOASReponseModel
object
9 properties
CompetitorContractResponseModel
object
13 properties 7 required
BadRequestModel
object
1 property
PersonContractResponseModelHATEOASReponseModel
object
9 properties
ExternalIdsViewModel
object
External system identifiers. Key represents the external system name (e.g., 'optaId', 'optaLegacyId', 'fibaId', 'vesselId','statsEngineId'), value represents t…
5 properties
ErrorModel
object
3 properties
PersonGenderType
integer
This property defines the possible person gender types which can be set as integer values. Each integer value is associated with relevant gender type as follow…
AcceptedModel
object
1 property
PersonHALEmbededResponse
object
10 properties 7 required
ContractResponseModel
object
14 properties 9 required
ContractResponseModelHATEOASReponseModel
object
9 properties
CreateCompetitorOfficialContract
object
8 properties 2 required
HALEmbededResponse
object
4 properties 3 required
JsonbModelViewModel
object
This model should be used to create or update single property value for specific property name for specific model.
2 properties 1 required
CreateContract
object
7 properties 3 required
ErrorDuplicateModel
object
2 properties
JsonbModel
object
3 properties
CompetitorPersonRoleType
integer
0 - Owned By (e.g. Competitor Horse owned by Person, Competitor Team owned by Person); 1 - PlaysFor (e.g. Person plays for Competitor Team); 3 - Trained By (e.…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

genius-sports-contracts-api-openapi.yml Raw ↑

Other APIs Genius Sports publishes across the network.

Genius Sports REST API
AE Profile APIs.io
Genius Sports Streaming API
AE Profile APIs.io
Genius Sports Publish API
AE Profile APIs.io
Genius Sports LiveStats In-Arena Feed
AE Profile APIs.io
Genius Sports Licensing API
AE Profile APIs.io
Genius Sports Competitions API
AE Profile APIs.io
Genius Sports Competitors API
AE Profile APIs.io
Genius Sports competitors/doubles API
AE Profile APIs.io
Genius Sports competitors/horses API
AE Profile APIs.io
Genius Sports competitors/players API
AE Profile APIs.io
Genius Sports competitors/tbds API
AE Profile APIs.io
Genius Sports competitors/teams API
AE Profile APIs.io
#Contracts
← Back to G APIs
API Details
ID
genius-sports:genius-sports-contracts-api
Base URL
https://fixtures.api.geniussports.com/v2
Docs
https://developer.geniussports.com/
Provider
Genius Sports
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=genius-sports-contracts-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/genius-sports-contracts-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Genius Sports Contracts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.