# Plan Pwsz Legnica — 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 real-time class schedules, faculty information, and teacher timetables for Collegium Witelona university to plan your courses and coordinate study group meetings. Find specific group schedules and individual teacher availability to optimize your academic calendar.

**Category:** Education | **Website:** [http://www.plan.pwsz.legnica.edu.pl/](http://www.plan.pwsz.legnica.edu.pl/) | **Docs:** [parse.bot/marketplace/f27f555b-78c7-4b3c-afe7-cabdf54a414f/plan-pwsz-legnica-edu-pl-api](https://parse.bot/marketplace/f27f555b-78c7-4b3c-afe7-cabdf54a414f/plan-pwsz-legnica-edu-pl-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/plan-pwsz-legnica/`
**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 group schedule

Retrieves the full semester schedule for a study group identified by specialization code. Returns all classes with day, date, time, subject, teacher, and room for each subgroup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `specialization` | string | Yes | Specialization code identifying the study group (e.g. 's1INF', 's1D', 's2DK'). Obtain from list_faculties endpoint. |

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

### Get teacher schedule

Retrieves the full semester schedule for a specific teacher. Returns all scheduled classes with dates, times, and details (groups, room, subject type).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `faculty_id` | string | No | Numeric faculty ID. |
| `teacher_id` | string | Yes | Numeric teacher ID from list_teachers endpoint. |

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

### List faculties

Lists all faculties and their study groups (specializations) with codes. Each specialization code can be used to fetch the group's semester schedule.

**Estimated cost:** Metered

_No parameters required._

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

### List teachers

Lists all teachers across all faculties with their IDs and faculty assignments. Teacher IDs can be used with get_teacher_schedule.

**Estimated cost:** Metered

_No parameters required._

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

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