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

> Explore GregMat's comprehensive GRE preparation resources by accessing study plans tailored to your learning pace, browsing video courses and recorded classes, and working through practice problems. Discover structured learning paths and stay updated with recently added course materials to guide your test prep journey.

**Category:** Education | **Website:** [www.gregmat.com/](https://www.gregmat.com/) | **Docs:** [parse.bot/marketplace/8ac79cd0-4c4c-432f-ab1d-3731b12ce1b7/gregmat-com-api](https://parse.bot/marketplace/8ac79cd0-4c4c-432f-ab1d-3731b12ce1b7/gregmat-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/gregmat/`
**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 course

Get a video course by slug, including all class groups and their individual class entries. Each class has a title, slug, description, image, and type. Class groups organize classes into thematic sections.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the course (e.g. 'must-see-videos'). |

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

### Get study plan

Get a specific study plan by slug, including all units with their content. Units contain HTML descriptions with links to videos, courses, and problems. Units may be marked plus_only independently of the plan itself.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the study plan. Available from list_study_plans results. |

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

### List problems

List GRE practice problems with optional filters for category, difficulty, question type, tags, and text search. Returns paginated problem listings with metadata including acceptance rate, difficulty, and whether a solution video exists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Problem category. |
| `difficulty` | string | No | Filter by difficulty level. |
| `limit` | integer | No | Maximum number of problems to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |
| `query` | string | No | Text search query to filter problems by title content. |
| `question_type` | string | No | Filter by question type (e.g. 'Quantitative Comparison', 'Multiple Choice', 'Numeric Entry (Not Fraction)', 'Multiple Select', 'TC 1 Blank'). |
| `tag` | string | No | Filter by tag ID number (e.g. '1' for Triangles, '2' for Fractions). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gregmat/list-problems \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","difficulty":"<string>","limit":"<integer>","offset":"<integer>","query":"<string>","question_type":"<string>","tag":"<string>"}'
```

### List recent classes

List recently completed classes (video recordings) with pagination. Returns class details including title, slug, type, schedule times, and associated courses. Ordered by most recent first.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of classes to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |

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

### List study plans

List all available GRE study plans with pagination. Returns plan titles, slugs, and whether they require a Plus subscription. Each plan can be fetched in detail via get_study_plan.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of study plans to return per page. |
| `offset` | integer | No | Number of results to skip for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gregmat/list-study-plans \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<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.