# Nuforc — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-nuforc-org-api-38fa01c3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-nuforc-org-api-38fa01c3/get_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nuforc-org-api-38fa01c3/list_months \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nuforc-org-api-38fa01c3/list_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-nuforc-org-api-38fa01c3/search_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<integer>","year":"<integer>"}'
```