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

> Search and discover open day events at educational institutions, view detailed event information and institution profiles, and browse the complete calendar of upcoming visits. Find the perfect school or university open day by searching institutions or exploring all available options with their program details and dates.

**Category:** Education | **Website:** [opendays.com/](https://opendays.com/) | **Docs:** [parse.bot/marketplace/023a4550-62aa-4665-bca8-91840581987e/opendays-com-api](https://parse.bot/marketplace/023a4550-62aa-4665-bca8-91840581987e/opendays-com-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-opendays-com-api-023a4550/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_calendar

Retrieve the open day calendar for a given month. Returns days with scheduled open day events including institution names, locations, and event slugs. Each call returns one month of events. When month/year are omitted, returns the current month's calendar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | No | Full month name in lowercase. Omitting returns the current month. |
| `year` | string | No | Four-digit year (e.g. 2025). Omitting returns the current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opendays-com-api-023a4550/get_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<string>"}'
```

### get_institution_profile

Retrieve the profile for a specific university or college, including contact details, website links, and campus addresses. The slug is obtained from search or list results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Institution slug from search or list results (e.g. university-of-portsmouth, abertay-university) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opendays-com-api-023a4550/get_institution_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_open_day_detail

Retrieve full details of a specific open day event by its URL slug. Returns event title, institution, date, time, location, description, and booking URL. The slug is obtained from calendar event listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Open day event slug from calendar results (e.g. university-of-york-open-day-id87113-5-September-2025) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opendays-com-api-023a4550/get_open_day_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_all_institutions

List all universities and colleges in the directory. Returns the complete set of institutions with their slugs and URLs. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opendays-com-api-023a4550/list_all_institutions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_institutions

Search for universities and colleges by name. Performs a case-insensitive substring match against the full institution directory. Returns matching institutions with their slugs for use with get_institution_profile.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against institution names (e.g. Portsmouth, London, Arts) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opendays-com-api-023a4550/search_institutions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```