# Pokerdb Thehendonmob — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find poker venues and casinos worldwide using the Hendon Mob Poker Database, with the ability to filter by starting letter and region or country to quickly locate games near you. Get detailed information about poker rooms and their locations to plan your next game.

**Category:** Sports | **Website:** [pokerdb.thehendonmob.com/venues/](https://pokerdb.thehendonmob.com/venues/) | **Docs:** [parse.bot/marketplace/abc8a176-099c-4ba7-a38c-773d9843ab1f/pokerdb-thehendonmob-com-api](https://parse.bot/marketplace/abc8a176-099c-4ba7-a38c-773d9843ab1f/pokerdb-thehendonmob-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_database_stats

Retrieve the current record counts (Players, Events, Results) displayed in the header of the Hendon Mob Poker Database homepage. Returns three integer counts representing the total number of players, events, and results tracked in the database. One request per call; no input parameters needed.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_database_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_event

Retrieve details and results for a specific poker event from the Hendon Mob database. Returns event metadata (name, date, venue, entries, prize pool) and a full list of finishers with their place, country, player name, player ID, and prize amounts. The event_id can be obtained from the get_festival_schedule endpoint's event_id field. One request per call; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric event ID (e.g. from get_festival_schedule results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_event \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_festival_schedule

Retrieve the full schedule for a specific poker festival from the Hendon Mob database. Returns festival metadata (name, country, venue, dates) and all scheduled events/tournaments with their dates, event names, winners (if available), and notes. The festival_id can be obtained from the list_festivals or list_events endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `festival_id` | string | Yes | Numeric festival ID (e.g. from list_festivals results or list_events festival_id field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_festival_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"festival_id":"<string>"}'
```

### get_player

Retrieve profile and career details for a specific poker player from the Hendon Mob database. Returns player name, country, nationality, birthplace, residence, total live earnings, best live cash, rankings, total career cashes, and up to 50 most recent tournament results with event names, dates, places, and prizes. The player_id can be obtained from the list_players endpoint. One request per call; results are capped at 50 most recent entries out of the player's full history (total_cashes reports the complete count).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID (e.g. from list_players results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_player \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_player_gallery

Retrieve the photo gallery for a specific poker player from the Hendon Mob database. Returns all gallery images with full-size image URLs, thumbnail URLs, and captions (when available). The player_id can be obtained from the list_players endpoint. One request per call; all images are returned in a single response (no pagination). Not all players have gallery images; an empty images array is valid for players without photos.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID (e.g. from list_players results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_player_gallery \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_player_rankings

Retrieve the complete list of rankings for a specific poker player from the Hendon Mob database. Returns all ranking entries including yearly money lists, all-time rankings, circuit-specific rankings, and WSOP rankings. Each entry shows the ranking name and the player's position. The player_id can be obtained from the list_players endpoint. One request per call; all rankings are returned in a single response (no pagination).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Numeric player ID (e.g. from list_players results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_player_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_ranking

Retrieve the full ranking list for a specific poker ranking from the Hendon Mob database. Returns 100 players per page with their rank, name, player ID, country, and value (earnings or points depending on ranking type). The ranking_id can be obtained from the list_rankings endpoint's ranking_id field. Pagination is controlled by the page parameter; has_next_page indicates whether more results exist. Large rankings (e.g. yearly money lists) may have thousands of pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (100 players per page). |
| `ranking_id` | string | Yes | Numeric ranking ID (e.g. from list_rankings ranking_id field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_ranking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","ranking_id":"<string>"}'
```

### get_venue

Retrieve details for a specific poker venue from the Hendon Mob database. Returns venue metadata including name, country, location, address, telephone, email, and website. The venue_slug can be obtained from the url_path field returned by list_venues (e.g. 'deerfoot-inn-casino-738'). One request per call; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `venue_slug` | string | Yes | Venue URL slug from list_venues url_path field, e.g. 'deerfoot-inn-casino-738' or 'parx-casino-1268'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/get_venue \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"venue_slug":"<string>"}'
```

### list_award_categories

List all poker award categories from the Hendon Mob database. Returns the complete list of award categories in a single response (no pagination needed). Each category includes its name, URL slug, logo path, and total number of recipients/winners.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_award_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_award_years

List poker award years from the Hendon Mob database. Returns all years that have awards recorded, along with the number of awards for each year. Single response with no pagination. Years are returned in descending order (most recent first).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_award_years \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_circuits

List all poker tours and circuits from the Hendon Mob database. Returns the complete list of available circuits in a single response (no pagination needed as the site serves all circuits on one page). Each circuit includes a code identifier and name.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_circuits \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_events

List poker events from the Hendon Mob database for a given week. Returns all events scheduled in the specified date range, grouped chronologically. Without date parameters, returns the current week's events. Pagination is by week: use the next_week_date value from the response as the date parameter to fetch the following week. Supports filtering by betting limit, game type, buy-in amount, and location (country/region or city with radius). Each request fetches one or more weeks of events (controlled by weeks parameter).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `buyin_crit` | string | No | Buy-in comparison operator. Options: l (<=), m (>=). Used with buyin_limit to filter events by buy-in amount. |
| `buyin_limit` | string | No | Buy-in amount threshold (numeric value). Used with buyin_crit and currency to filter events by buy-in amount. |
| `city` | string | No | City name for city-based filtering. Used when location=city. |
| `city_distance` | string | No | Distance radius around a city in miles. Options: 0 (exact location), 10, 25, 50, 100, 200, 300. Used when location=city. |
| `country` | string | No | Filter by region ID or country code. Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World, 8=United Kingdom, 9=All-Ireland, 11=Scandinavia, 12=GB and Ireland, 13=Eastern Europe, 14=Africa, 15=Asia, 17=Latin America. Country codes: USA, GBR, FRA, GER, AUS, CAN, etc. Omitting returns events worldwide. |
| `currency` | string | No | Buy-in currency for filtering. Options: USD, GBP, EUR. Used with buyin_crit and buyin_limit for buy-in filtering. |
| `date` | string | No | Start date in ISO format YYYY-MM-DD. Alternative to specifying day/month/year separately. If day/month/year params are provided, they take precedence over date. |
| `day` | string | No | Day of month (01-31). Defaults to current day if omitted. |
| `game` | string | No | Game type filter. Common options: HE (Hold'em), OM (Omaha), O8 (Omaha Hi/Lo), ST (7 Card Stud), MX (Mixed Games), HS (Hold'em Short Deck), BO (Big O). Full list includes 30+ game codes. Omitting returns all games. |
| `limit` | string | No | Betting limit filter. Options: LM (Limit), PL (Pot Limit), NL (No Limit), HP (Half Pot Limit), SL (Split Limit). Omitting returns all limits. |
| `location` | string | No | Location filter mode. Options: country (filter by country/region), city (filter by city name with optional radius). Default is country. |
| `month` | string | No | Month number (01-12). Defaults to current month if omitted. |
| `region` | string | No | Filter by region ID or country code (legacy alias for country parameter). Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World. Country codes: USA, CAN, GBR, etc. Omitting returns events worldwide. |
| `weeks` | integer | No | Number of weeks to display (1-10). |
| `year` | string | No | Year (1970-2066). Defaults to current year if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"buyin_crit":"<string>","buyin_limit":"<string>","city":"<string>","city_distance":"<string>","country":"<string>","currency":"<string>","date":"<string>","day":"<string>","game":"<string>","limit":"<string>","location":"<string>","month":"<string>","region":"<string>","weeks":"<integer>","year":"<string>"}'
```

### list_players

List poker players from the Hendon Mob database. Returns 100 players per page sorted alphabetically. Supports filtering by starting letter and by region or country code. Pagination is controlled by the page parameter; has_next_page indicates whether more results exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (100 players per page). |
| `region` | string | No | Filter by region ID or 3-letter country code. Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World, 14=Africa, 9=All-Ireland, 15=Asia, 13=Eastern Europe. Country codes: USA, CAN, GBR, FRA, etc. Omitting returns players worldwide. |
| `starting_letter` | string | No | Filter players by starting letter of their name. Accepts A-Z. Omitting returns all players. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","region":"<string>","starting_letter":"<string>"}'
```

### list_rankings

List poker ranking categories from the Hendon Mob database. Returns all available ranking lists with their top 5 players for the given filter criteria. Supports optional filtering by region, year, venue, and circuit. Without any filters, returns the default set of all-time and current rankings (typically 30 lists). With a year filter, returns year-specific ranking lists (typically 20+ lists). Each ranking entry includes the ranking name, a ranking ID (when available), and the top 5 players with their rank, name, country, player ID, and value (earnings or points depending on ranking type). One request per call; all matching rankings are returned in a single response (no pagination).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `circuit` | string | No | Filter by circuit code (e.g. '888', 'WPT', 'WSOP'). Obtainable from list_circuits circuit_code field. Omitting returns rankings for all circuits. |
| `country` | string | No | Filter by region ID. Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World. Additional IDs may be available in the site's dropdown. Omitting returns rankings worldwide. |
| `venue` | string | No | Filter by venue ID (numeric). Venue IDs can be found in the filter dropdown on the rankings page. Omitting returns rankings for all venues. |
| `year` | string | No | Filter by year (e.g. '2025', '2024'). Omitting returns all-time/default rankings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"circuit":"<string>","country":"<string>","venue":"<string>","year":"<string>"}'
```

### list_venue_recurring_festivals

List recurring festivals and tournaments for a specific poker venue from the Hendon Mob database. Returns all recurring events (running, upcoming, and past) with their festival IDs, names, dates, and status. The venue_slug can be obtained from the url_path field returned by list_venues (e.g. 'seminole-hard-rock-hotel-casino-382'). One request per call; all recurring festivals for the venue are returned in a single response (no pagination). Not all venues have recurring festivals; an empty festivals array is valid for venues without recurring events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `venue_slug` | string | Yes | Venue URL slug from list_venues url_path field, e.g. 'seminole-hard-rock-hotel-casino-382' or 'parx-casino-1268'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_venue_recurring_festivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"venue_slug":"<string>"}'
```

### list_venues

List poker venues from the Hendon Mob database. Returns 20 venues per page sorted alphabetically. Supports filtering by starting letter and by region or country code. Pagination is controlled by the page parameter; has_next_page indicates whether more results exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (20 venues per page). |
| `region` | string | No | Filter by region ID or 3-letter country code. Region IDs: 1=The Americas, 2=Europe, 3=Oceania, 4=Rest of the World, 8=United Kingdom, 9=All-Ireland, 11=Scandinavia, 12=GB and Ireland, 13=Eastern Europe, 14=Africa, 15=Asia, 17=Latin America. Country codes examples: USA, CAN, GBR, FRA, GER, AUS, BRA, JPN. Omitting returns venues worldwide. |
| `starting_letter` | string | No | Filter venues by starting letter. Accepts A-Z or # for non-alpha. Omitting returns all venues. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pokerdb-thehendonmob-com-api-abc8a176/list_venues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","region":"<string>","starting_letter":"<string>"}'
```