> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/origin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/origin/apis-all/sports-api.md).

# Sports API

Used to get detailed information about sports events, including schedules, global streaming availabilities, participants, and more!

### General Information&#x20;

The [Sports API](https://knowledgebase.fabricdata.com/origin/apis-all/sports-api/sports.md) contains endpoints that allow you to run searches for sports events, find events by ID, and check where games are available to stream.&#x20;

&#x20;

* **/Sports/{Id}**: Allows you to get a specific sports event by its unique ID.&#x20;
* **/Sports/FindByAlternateId:** Allows you to find an event using an alternate ID and ID Type.&#x20;
* **/Sports/Search/**: Allows you to make simple or complex searches for events using filters like Title, Event Date, Sport League, and streaming Providers.&#x20;

&#x20;

Review the examples below to see how to work with the Sports API. All metadata and images are intended to be ingested and cached by the customer. Only data records included in your solution will be returned by the API. If you have any questions please reach out to our support team.&#x20;

*Related API Guides:* [*Entertainment API*](https://knowledgebase.fabricdata.com/origin/apis-all/entertainment-api-docs.md)*,* [*Video API*](https://knowledgebase.fabricdata.com/origin/apis-all/video-api-docs.md)*,* [*Image API*](https://knowledgebase.fabricdata.com/origin/apis-all/image-api-docs.md)*.*&#x20;

### Get a Specific Event by ID&#x20;

Get a specific event's data by passing its Origin ID.&#x20;

* **Include extra data**: Includes=Participants, Availabilities, Images, Videos&#x20;

&#x20;

`https://api.origin.fabricdata.com/Sports/](https://api.origin.fabricdata.com/Sports/){Id}?Includes=Participants,Availabilities,Images,Videossubscription-key={YourKey}`&#x20;

&#x20;

### Search Sports Events&#x20;

Search for sports events using filters. In this example, we are searching for events within a specific league and bringing back paging and streaming availability.&#x20;

&#x20;

* **Filter**: SportLeague=NFL&#x20;
* **Include extra data**: Includes=Availabilities, Participants, AlternateTitles&#x20;
* **Paging**: Skip=0, Take=10&#x20;

&#x20;

`https://api.origin.fabricdata.com/Sports/Search/?SportLeague=NFL&Skip=0&Take=10&Includes=Availabilities,Participants,AlternateTitles&subscription-key={YourKey}`&#x20;

&#x20;

### Search Events by Provider&#x20;

Search for events that are available on a specific streaming provider (e.g., ESPN+, YouTube TV, Amazon Prime Video).&#x20;

&#x20;

* **Filter**: Providers=ESPN+&#x20;
* **Include extra data**: Includes=Availabilities, Descriptions&#x20;
* **Paging**: Skip=0, Take=10&#x20;

&#x20;

`https://api.origin.fabricdata.com/Sports/Search/?Providers=ESPN%2B(https://api.origin.fabricdata.com/Sports/Search/?Providers=ESPN%2B&Skip=0&Take=10&Includes=Availabilities,Descriptions&subscription-key={YourKey}`&#x20;

&#x20;

### Find By Alternate ID&#x20;

If you map your data using third-party or alternate IDs, you can look up a sports event directly using that AlternateId and the corresponding IdType.&#x20;

&#x20;

`https://api.origin.fabricdata.com/Sports/FindByAlternateId?Id={AlternateId}&IdType={IdType}&subscription-key={YourKey}`&#x20;
