# Nycgovparks — 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 events, park locations, and programs across New York City's parks system. Search and filter events by category, retrieve detailed event and park information, and explore recreation programs offered by the NYC Department of Parks & Recreation.

**Category:** Government & Public Data | **Website:** [nycgovparks.org/](https://nycgovparks.org/) | **Docs:** [parse.bot/marketplace/2883defc-34b7-4c6d-bc10-50285396e24d/nycgovparks-org-api](https://parse.bot/marketplace/2883defc-34b7-4c6d-bc10-50285396e24d/nycgovparks-org-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-nycgovparks-org-api-2883defc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_events

Retrieve all upcoming NYC Parks events. Returns paginated results with 50 events per page. Paginates by page number; results include title, date, location, borough, and description snippet for each event.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_all_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_event_detail

Retrieve full details for a specific event including title, description, location, park name, categories, and admission info. Requires the event URL from a listing endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL or relative path of the event detail page (e.g. 'https://www.nycgovparks.org/events/2026/05/01/line-dance-fitness' or '/events/2026/05/01/line-dance-fitness'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_kids_family_events

Retrieve events filtered by category slug. Supports category-based URL path filtering on the NYC Parks events system. Categories include kids, family, fitness, and free events.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug for filtering events. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_kids_family_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_park_details

Retrieve details for a specific park including name, description, and amenities list. The park_id can be an alphanumeric code like 'M010' or a slug like 'central-park'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `park_id` | string | Yes | The unique ID of the park (e.g. 'X034', 'M010', 'central-park'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_park_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"park_id":"<string>"}'
```

### get_parks_list

Retrieve all parks in NYC, optionally filtered by borough. Returns park names, IDs, and URLs. Borough filtering uses single-letter codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `borough_code` | string | No | Borough code to filter parks. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_parks_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"borough_code":"<string>"}'
```

### get_programs_for_kids

Retrieve youth and kids programs offered by NYC Parks, including camps, afterschool programs, fitness classes, and other recreational activities.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nycgovparks-org-api-2883defc/get_programs_for_kids \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```