Skip to main content

​
Search tutors

POST /api/v1/search
GET  /api/v1/search
Auth: None (public)

​
Parameters

ParameterTypeDescription
subject_idintFilter by subject
subject_level_idsarrayFilter by subject levels
exam_boardsarrayFilter by exam boards
datedateRequested lesson date
durationintLesson duration in minutes
post_codestringSearch location (UK postcode)
lat / lngfloatSearch coordinates (alternative to postcode)
sortstringSort order
filters[lesson_type]stringonline, tutors_home, students_home
filters[gender]stringmale, female
filters[language]intLanguage ID

​
Response

Paginated list of matching tutors, each with: 
{
  "id": 123,
  "firstname": "Jane",
  "lastname": "D",
  "profile_picture_url": "...",
  "location": {
    "distance": 5
  },
  "profile": {
    "tutoring_experience": "2 years 3 months"
  },
  "teaching_info": {
    "teach_id": 45,
    "subject": { "id": 1, "title": "Mathematics" },
    "subject_level": { "id": 2, "title": "GCSE" },
    "exam_boards": [...]
  },
  "lesson_price_breakdown": {
    "sign": "£",
    "currency_code": "GBP",
    "lesson_price": "30.00",
    "service_fee": "3.00",
    "total": "33.00"
  }
}

​
How it filters

See Tutor Search workflow for the full query chain. Key filters:
  1. Tutor must have complete profile (picture, video, bio, address, mobile)
  2. Must have passed all verifications (identity, DBS, qualifications)
  3. Must be visible (is_visible = true)
  4. Must have availability on requested date/day
  5. Must not be on holiday
  6. For in-person: must be within travel distance
  7. Max advance booking: 14 days

​
Reference data endpoints

These public endpoints return data needed to build search forms:

​
Subjects

GET /api/subjects
GET /api/v1/subjects           (auth:api, supports level filtering)

​
Subject groups

GET /api/subject-groups
Returns subjects organized by group: ACADEMIC, PROFESSIONAL, CUSTOM.

​
Subject levels

GET /api/v1/subject-levels     (auth:api)

​
Exam boards

GET /api/v1/exam-boards        (auth:api)

​
Countries

GET /api/countries

​
Lesson pricing

GET /api/lesson-price

​
Cancellation policies

GET /api/cancellation-policies

​
Lesson locations

GET /api/lesson-locations
GET /api/v1/lesson-locations    (auth:api)
Returns available lesson types: TUTORS_HOME (1), STUDENTS_HOME (2), ONLINE (3).