# Pdga — 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.

> Access player profiles, ratings history, tournament events, live scoring, world rankings, and the course directory from the Professional Disc Golf Association.

**Category:** Sports | **Website:** [pdga.com/](https://pdga.com/) | **Docs:** [parse.bot/marketplace/4ae4bc2e-e88b-4688-95e2-d44a59201635/pdga-com-api](https://parse.bot/marketplace/4ae4bc2e-e88b-4688-95e2-d44a59201635/pdga-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-pdga-com-api-4ae4bc2e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_event_details

Retrieve full details and official results for a specific PDGA event. For completed events, returns player results organized by division (place, player name, PDGA number, rating). For in-progress events, returns current standings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID from search_events results (e.g. '104527'). |

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

### get_live_event_scores

Retrieve live scoring data for a tournament from the PDGA live API. Returns detailed event metadata including divisions, course layouts with hole-by-hole details, round schedule, and scoring format. Available for events with live scoring enabled.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Event ID for the tournament (e.g. '104527'). |

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

### get_player_profile

Retrieve a player's full profile including career statistics, current rating, location, classification, and current-season tournament totals. Requires the player's PDGA number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pdga_number` | string | Yes | Player's PDGA number (e.g. '27523'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/get_player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdga_number":"<string>"}'
```

### get_player_ratings_detail

Retrieve a player's round-by-round ratings history showing every rated tournament round, including score, round rating, tier, division, and whether the round was evaluated and included in the player's official rating.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `pdga_number` | string | Yes | Player's PDGA number (e.g. '27523'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/get_player_ratings_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdga_number":"<string>"}'
```

### get_world_rankings

Retrieve the current PDGA world rankings summary showing the top 5 players for MPO (Mixed Pro Open) and FPO (Female Pro Open) divisions. Each entry includes player rank, name, and profile URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/get_world_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_courses

Search the PDGA course directory by course name. Returns paginated results with course metadata including establishment year, location, number of holes, and course URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-based). |
| `title` | string | No | Course name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/search_courses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","title":"<string>"}'
```

### search_events

Search the PDGA tour schedule for disc golf events/tournaments by name. Returns paginated results with event metadata including tier, class, location, dates, and tournament director.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_name` | string | No | Event name to search for. |
| `page` | integer | No | Page number for pagination (0-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/search_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_name":"<string>","page":"<integer>"}'
```

### search_players

Search the PDGA player directory by name or PDGA number. Returns paginated results with basic player info (name, rating, classification, location, membership status). At least one of first_name, last_name, or pdga_num should be provided. pdga_num searches independently and should not be combined with name filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | Player's first name to search for. |
| `last_name` | string | No | Player's last name to search for. |
| `page` | integer | No | Page number for pagination (0-based). |
| `pdga_num` | string | No | PDGA membership number to search for. Use alone without name filters. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pdga-com-api-4ae4bc2e/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"<string>","last_name":"<string>","page":"<integer>","pdga_num":"<string>"}'
```