# Introduction

Welcome to the Cricket API documentation. This API provides access to a wide range of cricket-related data, including live scores, player statistics, team information, and more. Whether you're building a cricket app, or website, or integrating cricket data into your system, this documentation will guide you through the usage of our API.

### Base URL

The base URL for all API endpoints is `https://cricket.sportsjupiter.com/v1`. Make sure to prepend this to each endpoint when making requests.

### Authentication

To access the Cricket API, you need to include your API key in the URL query parameter. You can find the API token on the dashboard.

<figure><img src="https://21025793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDy6DJGRbnKebmTWQrc9Q%2Fuploads%2FpSKIwqihABlcPLwE7YXf%2Fdashboard.png?alt=media&#x26;token=05f5689a-9a7f-4729-8187-81a0c91c6169" alt=""><figcaption><p>Dashboard</p></figcaption></figure>

### First request

Below is a request for `fixture`API along with the secret API token which you can find in your SportsJupiter account.

[https://cricket.sportsjupiter.com/v1/fixture?api\_token={api\_token}\&fixture\_id=51890](https://cricket.sportsjupiter.com/v1/fixture?api_token=d28295a9-3e65-4aef-89c5-9c39fe2b15ea\&fixture_id=51890)&#x20;

<table data-full-width="false"><thead><tr><th width="203">Status code</th><th width="546.3333333333333">Description</th></tr></thead><tbody><tr><td><code>200</code></td><td>Successful request and data was returned</td></tr><tr><td><code>400</code></td><td>Part of the request is malformed, the exact reason can be found in the response</td></tr><tr><td><code>401</code></td><td>Unauthorized access</td></tr><tr><td><code>500</code></td><td>Internal error with our servers</td></tr></tbody></table>

### Note

The best way to understand the API data structure is to hit all of the examples provided in this documentation. All our endpoints are self-explanatory and easy to understand. Please feel free to contact us if you have any queries regarding our APIs
