---
title: "Searches for teaching events."
method: GET
path: "/api/teaching_events/search"
tags: ["Teaching Events"]
---

# Searches for teaching events.

`GET /api/teaching_events/search`

Searches for teaching events. Optionally limit the results by distance (in miles) from a postcode, event type and start date.

## Query parameters

- `Postcode` string, nullable — Postcode to center search around.
- `Radius` integer, nullable — Set to filter results to a radius (in miles) around the postcode.
- `TypeIds` integer[], nullable — Set to filter results to a type of teaching event. Each ID must match a `typeId` of the `TeachingEvent` schema.
- `Online` boolean, nullable — Set to true to return only online events and false to return only in-person events.
- `StartAfter` string, date-time, nullable — Set to filter results to those that start after a given date.
- `StartBefore` string, date-time, nullable — Set to filter results to those that start before a given date.
- `StatusIds` integer[], nullable — Set to filter results by event status.
- `AccessibilityOptions` integer[], nullable — Set to filter results by accessibility options.
- `quantity` integer

## Response `200`

OK

- TeachingEvent[]
  - `id` string, uuid, nullable
  - `typeId` integer
  - `statusId` integer
  - `regionId` integer, nullable
  - `readableId` string, required
  - `webFeedId` string, nullable — If set, the API will accept new attendees for this event (an external sign up should be used if this value is nil).
  - `isOnline` boolean
  - `name` string, required
  - `summary` string, nullable
  - `message` string, nullable — Used to push miscellaneous messages to users (if an event is close to being booked out, for example).
  - `description` string, nullable
  - `videoUrl` string, nullable
  - `scribbleId` string, nullable
  - `providerWebsiteUrl` string, nullable
  - `providerTargetAudience` string, nullable
  - `providerOrganiser` string, nullable
  - `providerContactEmail` string, email, nullable
  - `startAt` string, date-time
  - `endAt` string, date-time
  - `providersList` string, nullable
  - `building` TeachingEventBuilding
    - `id` string, uuid, nullable
    - `venue` string, required
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `addressLine3` string, nullable
    - `addressCity` string, nullable
    - `addressPostcode` string, nullable
    - `imageUrl` string, nullable
  - `isVirtual` boolean
  - `accessibilityOptions` integer[], nullable
  - `isInPerson` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/department-for-education/apis/get-into-teaching-api-v1.md) · [All operations](https://skmtc.net/department-for-education/apis/get-into-teaching-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/department-for-education/get-into-teaching-api-v1/versions/5d53dbaed560/schema)