# Maradminbot — 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 retrieve official Marine Corps MARADMIN announcements from Marines.mil, filtering by year, status, and keyword to stay updated on the latest personnel and administrative directives. Get detailed information about specific announcements by number or browse the most recent updates to ensure you never miss critical Marine Corps guidance.

**Category:** Government & Public Data | **Website:** [maradminbot.com/](https://maradminbot.com/) | **Docs:** [parse.bot/marketplace/89be73b9-2212-4d32-9acf-432b7c60afad/maradminbot-com-api](https://parse.bot/marketplace/89be73b9-2212-4d32-9acf-432b7c60afad/maradminbot-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/maradminbot/`
**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

### Filter maradmins by status

Filter MARADMIN announcements by status. Returns announcements matching the specified status via server-side filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Status to filter by. |

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

### Filter maradmins by year

Filter MARADMIN announcements by year. Returns all announcements published in the specified year via server-side filtering.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | Four-digit year to filter by (e.g. '2025', '2026'). |

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

### Get latest maradmins

Retrieve the latest N MARADMIN announcements from the first page of the listing. A convenience endpoint that returns the most recent announcements without pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (up to 27, the page size). |

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

### Get maradmin by number

Retrieve a specific MARADMIN by its number. Searches for the number and returns the full detail (title, date, body) of the matching announcement. If no exact match is found, returns the closest result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `number` | string | Yes | MARADMIN number in format NNN/YY (e.g. '271/26', '055/26'). |

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

### Get maradmin detail

Fetch the full text content and metadata of a specific MARADMIN announcement given its URL. The URL is typically obtained from list or search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the MARADMIN article page on marines.mil (from list_maradmins or search_maradmins results). |

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

### List maradmins

Retrieve a paginated list of MARADMIN announcements from the Marines.mil portal. Returns up to 27 items per page. Pagination advances by integer page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. |

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

### Search maradmins

Search for MARADMIN announcements by keyword. Performs a server-side keyword search against the Marines.mil MARADMIN listing and returns matching results. The search covers title and content fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'promotion', 'drill instructor', or a MARADMIN number like '271/26'). |

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