# Plan Pwsz Legnica — 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.

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-plan-pwsz-legnica-edu-pl-api-f27f555b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-plan-pwsz-legnica-edu-pl-api-f27f555b/get_group_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-plan-pwsz-legnica-edu-pl-api-f27f555b/get_teacher_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-plan-pwsz-legnica-edu-pl-api-f27f555b/list_faculties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-plan-pwsz-legnica-edu-pl-api-f27f555b/list_teachers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
