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

> Discover skateboard spots around the world including street spots, skateparks, and skate shops with detailed information like addresses, coordinates, images, and social stats. Search for specific locations or browse all available spots to find your next skate session anywhere globally.

**Category:** Maps & Geospatial | **Website:** [app.getloke.com/skate-spots/@-74.0242,40.6941,3.00z](https://app.getloke.com/skate-spots/@-74.0242,40.6941,3.00z) | **Docs:** [parse.bot/marketplace/2ece74bf-835e-4497-9df0-bd2fb7aed547/app-getloke-com-api](https://parse.bot/marketplace/2ece74bf-835e-4497-9df0-bd2fb7aed547/app-getloke-com-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/getloke/`
**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 spots

Get all skateboard spots with basic info. Supports optional filtering by spot type and search query. Returns ~27,000 spots with name, type, and coordinates. Type and query filters are applied client-side after fetching.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query to filter spots by name. |
| `type` | string | No | Filter by spot type. Accepted values include Park, Ledge, Rail, Gap, Stairs, Bank, Ramp, Pad, Flatland, Downhill, Wallride. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/getloke/get-all-spots \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","type":"<string>"}'
```

### Get spot details

Get detailed information for a specific skateboard spot including full address, social stats (likes, comments, views), founder info, and approval status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `spot_id` | string | Yes | The spot ID (numeric, get IDs from the get_all_spots endpoint). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/getloke/get-spot-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"spot_id":"<string>"}'
```

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