# Arts — 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 California arts funding opportunities by browsing grant programs, searching awarded grantees, and accessing resources from the California Arts Council. Find relevant grants and grantee information while staying updated with the latest news and resources in California's arts funding landscape.

**Category:** Government & Public Data | **Website:** [arts.ca.gov/](https://arts.ca.gov/) | **Docs:** [parse.bot/marketplace/15987bfa-a550-495e-a242-9d7bae81ebc4/arts-ca-gov-api](https://parse.bot/marketplace/15987bfa-a550-495e-a242-9d7bae81ebc4/arts-ca-gov-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/arts/`
**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 grant program detail

Get detailed information for a specific grant program including content sections (background, eligibility, funding restrictions, timelines) and application links. Requires a program slug from list_grant_programs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Grant program slug from list_grant_programs results (e.g., 'impact-projects', 'arts-youth'). |

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

### Get grantee detail

Get detailed information about a specific grant award/grantee including organization info, award details, contact information, and project description. Requires a grantee slug from search_grantee_database results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Grantee slug from search_grantee_database results (e.g., 'dance-kaiso'). |

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

### List grant programs

List all available grant programs from the California Arts Council. Supports pagination and optional year filtering. Returns program titles, slugs, URLs, and brief descriptions. Each program slug can be passed to get_grant_program_detail for full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `year` | string | No | Filter by grant program year category. Values correspond to site categories (e.g., 'grants-for-2024', 'grants-for-2025', 'grants-for-2026'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/arts/list-grant-programs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","year":"<string>"}'
```

### List news

List news articles and press releases from the California Arts Council. Returns paginated results ordered by date descending with titles, URLs, slugs, and publication dates.

**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/arts/list-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search grantee database

Search the grantee database for past grant awards. Supports keyword and year filtering. Returns up to 500 results per page with organization details and award amounts. Each result includes an organization_slug for use with get_grantee_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Keyword search (e.g., 'dance', 'theater'). |
| `year` | string | No | Filter by grant fiscal year (e.g., '2022-23'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/arts/search-grantee-database \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","year":"<string>"}'
```

### Search site

Search the entire California Arts Council website for content. Returns paginated results with titles, URLs, and text snippets. Useful for finding resources about eligibility, guidelines, and general arts council information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword(s). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/arts/search-site \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<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.