# Cambridgema Iqm2 — 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 municipal meeting schedules, details, and documents from an IQM2-powered government meeting portal. Search across boards, commissions, and calendar years to retrieve meeting information, document links (agendas, minutes, final actions), group listings, and RSS feed notifications for local government proceedings.

**Category:** Government & Public Data | **Website:** [cambridgema.iqm2.com/](https://cambridgema.iqm2.com/) | **Docs:** [parse.bot/marketplace/1d336be2-ca4c-4e33-bdae-f2f0f251d7a1/cambridgema-iqm2-com-api](https://parse.bot/marketplace/1d336be2-ca4c-4e33-bdae-f2f0f251d7a1/cambridgema-iqm2-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/cambridgema-iqm2/`
**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 boards list

Get list of all boards and commissions with their descriptions, meeting frequency, members, and other metadata. Returns comprehensive information about each municipal body including current membership.

**Estimated cost:** Metered

_No parameters required._

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

### Get calendar rss feed

Get the latest meeting entries from the portal RSS feed. Returns recently published meeting agenda notifications.

**Estimated cost:** Metered

_No parameters required._

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

### Get meeting detail

Get full details for a specific meeting including board name, type, date/time, status, documents, and agenda items. Requires a meeting ID obtained from get_meetings_list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Meeting ID (from get_meetings_list results). |

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

### Get meeting document url

Construct the direct URL for a meeting document given the meeting ID and document type code. Does not fetch the document; returns the URL for download.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Meeting ID (from get_meetings_list or get_meeting_detail results). |
| `type` | string | Yes | Document type code: 14 (Agenda Summary), 1 (Agenda Packet), 15 (Final Actions), 12 (Minutes), 4 (Minutes alternate). |

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

### Get meeting groups

Retrieve all available meeting group IDs and names from the calendar filter dropdown. Each group represents a board, commission, or committee. Use these IDs with get_meetings_list or get_meetings_by_group to filter meetings by group.

**Estimated cost:** Metered

_No parameters required._

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

### Get meetings by group

Get meetings for a specific group in the default year (2024). Not all groups have meetings; some may return an empty list. Use get_meeting_groups to discover valid group IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `group_id` | string | Yes | Meeting group ID (from get_meeting_groups endpoint). |

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

### Get meetings by year

Get all meetings for a specific calendar year across all groups. Equivalent to get_meetings_list with just a year filter. Returns meeting summaries with documents.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | Calendar year (e.g. 2024, 2025). |

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

### Get meetings list

Get list of meetings filtered by date range, year, and optionally by group ID. Returns all meetings across all groups for the specified year by default. Each meeting includes date/time, group name, meeting type, status, and links to available documents.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | string | No | Start date in m/d/yyyy format (e.g. 1/1/2024). Defaults to 1/1/{year}. |
| `group_id` | string | No | Meeting group ID to filter by (from get_meeting_groups endpoint). Omitting returns all groups. |
| `to` | string | No | End date in m/d/yyyy format (e.g. 12/31/2024). Defaults to 12/31/{year}. |
| `year` | string | No | Calendar year to filter meetings (e.g. 2024, 2025). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/cambridgema-iqm2/get-meetings-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"from":"<string>","group_id":"<string>","to":"<string>","year":"<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.