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

> Search and access detailed UFO sighting reports from the National UFO Reporting Center database, including witness accounts, locations, and images organized by date. Discover documented sightings with specific details to research UFO phenomena and explore reports from around the world.

**Category:** Government & Public Data | **Website:** [nuforc.org/](https://nuforc.org/) | **Docs:** [parse.bot/marketplace/38fa01c3-5d8a-476f-a152-9d16bbd9a05c/nuforc-org-api](https://parse.bot/marketplace/38fa01c3-5d8a-476f-a152-9d16bbd9a05c/nuforc-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/nuforc/`
**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 report

Get detailed information for a specific UFO sighting report including all structured fields and the witness description. Fields present vary by report; some reports may have empty values for optional fields like images, explanation, or color.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `report_id` | string | Yes | Numeric report ID from list_reports results (e.g., '190000'). |

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

### List months

List all available months in the NUFORC databank. Each month has an ID (e.g., 'e202401') used as input for list_reports and search_reports endpoints. Returns months ordered from newest to oldest.

**Estimated cost:** Metered

_No parameters required._

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

### List reports

List all UFO sighting report summaries for a specific month. Returns basic metadata for each report including location, shape, and summary text. Use month IDs from list_months endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month_id` | string | Yes | Month identifier from list_months endpoint, matching pattern 'eYYYYMM' (e.g., 'e202401' for January 2024). |

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

### Search reports

Search for reports by year and optionally month. When month is provided, returns report summaries for that specific month. When only year is provided, returns the list of available months for that year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | integer | No | Month number (1-12). When provided, returns reports for that month. When omitted, returns available months for the year. |
| `year` | integer | Yes | Year to search (e.g., 2024). |

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

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