---
title: "Lookup Ids"
method: GET
path: "/v1/ids/lookup"
tags: ["Events & Odds"]
---

# Lookup Ids

`GET /v1/ids/lookup`

## Request

- Base URL: `https://api.prop-line.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.prop-line.com/v1/ids/lookup`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `apiKey`

Find our events from an id someone else assigned: a sportsbook's own
event id, ESPN's, or MLB's gamePk. Returns the same crosswalk as
/sports/{sport}/ids plus the score and status, for any date. Free tier.

Or by names: sport + home + away + kickoff finds the event whose two
teams those are (either order) within window_hours of kickoff.

## Query parameters

- `book` string, nullable: Book key whose id you hold, e.g. pinnacle, draftkings, kalshi.
- `book_event_id` string, nullable: That book's own event id(s), comma-separated (max 50).
- `espn_event_id` string, nullable: ESPN event id(s), comma-separated.
- `mlb_game_pk` string, nullable: MLB gamePk(s), comma-separated.
- `sport` string, nullable: Sport key, for a lookup by team names.
- `home` string, nullable: One team's name (either side), with away + kickoff.
- `away` string, nullable: The other team's name.
- `kickoff` string, date-time, nullable: Kickoff, ISO 8601 (UTC if no offset).
- `window_hours` number: How far from kickoff to look, in hours (default 6, max 72).

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 89 revisions in range; 4 not diffed.

- **2026-10-29** `0192eb15e86f`: 5 info
  - added the new optional `query` request parameter `away`
  - added the new optional `query` request parameter `home`
  - added the new optional `query` request parameter `kickoff`
  - added the new optional `query` request parameter `sport`
  - …1 more
- **2026-10-28** `d75f5fc62647`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prop-line/apis/player-props-api/changes/v1/ids/lookup/get.md)

---

[API](https://skmtc.dev/prop-line/apis/player-props-api.md) - [All operations](https://skmtc.dev/prop-line/apis/player-props-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prop-line/apis/player-props-api/revisions/d3654129ada4?raw)