# Nycgovparks — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-all-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-event-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-kids-family-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-park-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-parks-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nycgovparks/get-programs-for-kids \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.