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

Genius Sports Ingestion API

The Ingestion API from Genius Sports — 12 operation(s) for ingestion.

Genius Sports Ingestion 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 Ingestion. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 22 operations across 12 paths, and defines 79 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.

22 operations 12 paths 79 schemas 9 GET9 OPTIONS1 PATCH3 POST

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
License
Resource Areas
1

Authentication & Security 2

Genius Sports Ingestion 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 22

Across 12 paths, the API surfaces 22 operations — 9 GET, 9 OPTIONS, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Ingestion 22
OPTIONS
/ingestion/competitions/searchById
→ 200
GET
/ingestion/competitions/searchById
Search for ingestion proposals by competition Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/competitions/searchBySourceEntityId
→ 200
GET
/ingestion/competitions/searchBySourceEntityId
Search for ingestion proposals by source entity Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/competitions/{trackingRequestId}/status
1 param → 200
GET
/ingestion/competitions/{trackingRequestId}/status
Tracking the progress of the asynchronous execution.
2 params → 200520400301500401413403
OPTIONS
/ingestion/fixtures/searchById
→ 200
GET
/ingestion/fixtures/searchById
Search for ingestion proposals by fixture Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/fixtures/searchBySourceEntityId
→ 200
GET
/ingestion/fixtures/searchBySourceEntityId
Search for ingestion proposals by source entity Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/fixtures/{trackingRequestId}/status
1 param → 200
GET
/ingestion/fixtures/{trackingRequestId}/status
Tracking the progress of the asynchronous execution.
2 params → 200520400301500401413403
OPTIONS
/ingestion/squads/searchById
→ 200
GET
/ingestion/squads/searchById
Search for ingestion proposals by squad Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/squads/searchBySourceEntityId
→ 200
GET
/ingestion/squads/searchBySourceEntityId
Search for ingestion proposals by source entity Id.
4 params → 200520400301500401413403
OPTIONS
/ingestion/squads/{trackingRequestId}/status
1 param → 200
GET
/ingestion/squads/{trackingRequestId}/status
Tracking the progress of the asynchronous execution.
2 params → 200520400301500401413403
POST
/ingestion/competitions
Ingest competition data for update or create
3 params → 520400202500404504429
POST
/ingestion/fixtures
Ingest fixture data for update or create
3 params → 520400202500404504429
PATCH
/ingestion/fixtures
Patch existing fixture request. Currently support only lineups patch by sourceEntityId of the fixture.
3 params → 520400202500404504429
POST
/ingestion/squads
Ingest team squad players data for update or create
3 params → 520400202500404504429

Schemas 79

The contract defines 79 schemas that model the data the API accepts and returns. The most detailed are proposalFixtureIngestionData (11 properties), fixtureIngestion (10 properties), playerMatchModel (10 properties), fixtureResponseMatchModel (10 properties). Each schema is shown below with its type and property counts.

Error
object
5 properties 3 required
fixtureMatchModel
coverageData
object
3 properties
officialReadonlyResponseModel
sourceCoverage
object
2 properties
proposalDataBase
object
4 properties
proposalCompetitionPhaseData
proposalSquadPlayerData
competitorReadonlyResponseModel
proposalCompetitionData
competitionPhaseReadonlyResponseModel
teamMatchModel
squadTrackingStatusResponse
object
3 properties
proposalCompetition
object
5 properties
competitionType
string
Defines the type of the competition to increase chances of correct matching
proposalSeasonData
competitorType
string
Defines the type of the competitor to increase chances of correct matching
teamPropertiesModel
object
4 properties
proposalSquadIngestionData
object
5 properties
proposalFixture
object
5 properties
coverage
array
competitionIngestion
object
4 properties 2 required
proposalSquad
object
5 properties
competitionResponseMatchModel
object
5 properties 2 required
fixtureResponseMatchModel
object
10 properties 3 required
lineupPlayer
fixtureIngestionPatch
object
2 properties 2 required
trackingRequestModel
object
Tracking Id of the progress of the asynchronous execution.
1 property 1 required
squadIngestion
object
6 properties 3 required
proposalCompetitionIngestionData
object
5 properties
lineup
object
2 properties
sportSpecificRules
array
firstLastNameModel
object
2 properties
proposalPersonData
object
2 properties
basePlayerPropertiesModel
playerMatchModel
object
10 properties
fixtureIngestion
object
10 properties 4 required
proposalLocalityData
object
2 properties
ArrayOfproposalCompetition
array
official
venueMatchModel
Empty
object
baseDbModel
object
2 properties 1 required
squadResponseMatchModel
object
5 properties 3 required
competitionTrackingStatusResponse
object
3 properties
SimplifiedTrackingStatus
integer
Status of the proposal request: Accepted = 0, AwaitingMatching = 1, MatchedAndProposed = 3, ProposedAndApproved = 5, InvalidProposal = 7, Matched = 8, FailedTo…
organizationMatchModel
officials
array
fixtureCompetitorMatchModel
playerPropertiesModel
ArrayOfproposalFixture
array
proposalOrganizationData
competitorMatchModel
gender
string
If sent an EXACT match is made on the enum, excluding all non-matching entities.
competitionMatchModel
fixtureTrackingStatusResponse
object
3 properties
baseMatchModel
proposalCompetitorData
proposalSquadTeamData
officialsReadonlyResponseModel
array
lineupReadonlyResponseModel
object
7 properties 1 required
proposalVenueData
proposalSportData
proposalFixtureData
sportSpecificRule
object
2 properties
competitionPhaseMatchModel
proposalFixtureIngestionData
object
11 properties
BadRequestModel
object
1 property
proposalLineupData
ErrorModel
object
3 properties
competitionReadonlyResponseModel
ArrayOfproposalSquad
array
ageCategory
string
Default is Senior. One of: U5, U6, U7, U8, U9, U10, U11, U12, U13, U14, U15, U16, U17, U18, U19, U20, U21, U22, U23, Senior
proposalOfficialData
locality
string
If sent а FUZZY match is made on the value and the similarity score is contributing to the end match score.
organizationReadonlyResponseModel
fixtureReadonlyResponseModel
baseResponseMatchModel
doublesPropertiesModel
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Genius Sports publishes across the network.

Genius Sports REST API
Genius Sports Streaming API
Genius Sports Publish API
Genius Sports LiveStats In-Arena Feed
Genius Sports Licensing API
Genius Sports Competitions API
Genius Sports Competitors API
Genius Sports competitors/doubles API
Genius Sports competitors/horses API
Genius Sports competitors/players API
Genius Sports competitors/tbds API
Genius Sports competitors/teams API
Where this information came from

This is an independent, third-party profile of Genius Sports Ingestion 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.