# MotoGP Results and Classifications API

> MotoGP, Moto2 and Moto3: seasons, Grands Prix, sessions and classifications with riders and times

- Vendor: `motogpresultsandclassification` · version 1.0 · category Sports · tags motogp api, motorcycle racing api, grand prix results api, moto2 api, moto3 api, racing classification api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/motogpresultsandclassification
- This document: https://apiclay.com/docs/motogpresultsandclassification.md
- OpenAPI 3.1: https://apiclay.com/api/motogpresultsandclassification/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `motogpresultsandclassification`
- Updated: 2026-11-18

## About

## MotoGP Results and Classifications API

The results API behind MotoGP.com: seasons back to the championship's start, each season's events (Grands Prix and tests) with circuit, country and dates, the classes (MotoGP, Moto2, Moto3, MotoE), every session of an event per class (practice, qualifying, sprint, warm-up, race) and a session's classification with position, rider, team, constructor, laps, time, gap, top speed and points.

Data comes from **motogp.com** (https://www.motogp.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/seasons`, then `/events?seasonUuid=&amp;isFinished=true` and `/categories?seasonUuid=`, then `/sessions?eventUuid=&amp;categoryUuid=`, then `/classification?session=`.

### Routes

#### GET `/seasons` - Seasons
No parameters.

Returns: Array: `id`, `year`, `current`.

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| seasonUuid | query | string | yes | Season `id` from `/seasons`. |
| isFinished | query | string | no | `true` for completed events only. |

Returns: Array: `id`, `name`, `sponsored_name`, `short_name`, `circuit`, `country`, `date_start`, `date_end`, `status`, `test`, `event_files`.

#### GET `/categories` - Categories
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| seasonUuid | query | string | yes | Season `id`. |

Returns: Array: `id`, `name` (MotoGP, Moto2, Moto3, MotoE), `legacy_id`.

#### GET `/sessions` - Sessions
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| eventUuid | query | string | yes | Event `id` from `/events`. |
| categoryUuid | query | string | yes | Class `id` from `/categories`. |

Returns: Array: `id`, `type` (`FP`, `PR`, `Q`, `SPR`, `WUP`, `RAC`), `number`, `date`, `status`, `condition` (track and weather), `session_files`.

#### GET `/classification` - Classification
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| session | path | string | yes | Session `id` from `/sessions`. |

Returns: `classification`: `position`, `rider` (`full_name`, `country`, `number`), `team`, `constructor`, `total_laps`, `time`, `gap`, `top_speed`, `average_speed`, `points`, `status`; `records`, `file`.

### Caveats

- Rider names and nationalities are public sporting results.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by motogp.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /seasons — Seasons
- Gateway: `GET https://api.apiclay.com/v1/api/motogpresultsandclassification/seasons`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/motogpresultsandclassification/events`
- Public query params: `seasonUuid` (string, required), `isFinished` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/motogpresultsandclassification/categories`
- Public query params: `seasonUuid` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /sessions — Sessions
- Gateway: `GET https://api.apiclay.com/v1/api/motogpresultsandclassification/sessions`
- Public query params: `eventUuid` (string, required), `categoryUuid` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /classification — Classification
- Gateway: `GET https://api.apiclay.com/v1/api/motogpresultsandclassification/classification`
- Public query params: `session` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/motogpresultsandclassification/seasons" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
