# Nass — 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 comprehensive agricultural statistics from the USDA, including crop production data, livestock numbers, and farm economics through the QuickStats database, while also discovering available parameters and viewing the publications calendar. Search, filter, and retrieve detailed agricultural data by region, commodity, and time period to support farming decisions and agricultural analysis.

**Category:** Government & Public Data | **Website:** [nass.usda.gov/](https://nass.usda.gov/) | **Docs:** [parse.bot/marketplace/b56facbd-170e-47ed-a0b1-90fd87225c1b/nass-usda-gov-api](https://parse.bot/marketplace/b56facbd-170e-47ed-a0b1-90fd87225c1b/nass-usda-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/nass/`
**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 cropland data layer links

Retrieve download links for the Cropland Data Layer (CDL) national and state-level datasets. Returns URLs for GeoTIFF/ZIP files including national CDLs (10m and 30m), cultivated layers, frequency layers, and confidence layers from 2008 to present. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nass/get-cropland-data-layer-links \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get publications calendar

Retrieve scheduled reports from the NASS publications calendar for a specific month and year. Returns report titles with links to the calendar landing pages. Each report includes parsed URL parameters such as report_id, source, day, month, and year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | No | Month in zero-padded MM format (01-12). |
| `year` | string | No | Year in YYYY format. |

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

### Quickstats discover params

Discover valid parameter values for building QuickStats queries using the keyless internal web API. Returns all accepted values for a target parameter, optionally filtered by sector. Use to enumerate sectors, commodity groups, commodities, states, statistical categories, and aggregation levels available in the QuickStats database.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sector_desc` | string | No | Filter values by sector. |
| `target_param` | string | No | The parameter to discover values for (e.g., sector_desc, group_desc, commodity_desc, state_alpha, statisticcat_desc, agg_level_desc). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nass/quickstats-discover-params \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sector_desc":"<string>","target_param":"<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.