> For the complete documentation index, see [llms.txt](https://docs.matchplay.events/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.matchplay.events/opdb-and-pintips-api.md).

# OPDB & PinTips API

{% hint style="info" %}

## You probably don't need OPDB endpoints

When working OPDB data it's often most efficient to download [the entire OPDB data set](/data-exports.md) as a data export instead of fetching machine details one by one.
{% endhint %}

## Get OPDB changelog

```http
GET /api/opdb/changelog
```

Get the [OPDB changelog](https://app.matchplay.events/opdb/changelog) which you can use to update OPDB IDs which have been moved or deleted.

## Get OPDB entry

```http
GET /api/opdb/entries/{opdbId}
```

Get a single OPDB entry including any tutorial videos. Do not use if you're fetching data for many entries. Instead [download the entire OPDB data set as one export](/data-exports.md#export-opdb).

## Get PinTips

```http
GET /api/pintips
```

Get PinTips (short playing tips) for a single OPDB entry or Match Play arena.

**Query params**

| Name               | Description                          |
| ------------------ | ------------------------------------ |
| `opdbId` (string)  | Optional. OPDB id to get PinTips for |
| `arenaId` (number) | Optional. Arena to get PinTips for   |