---
title: "Get EVOLVE Visits"
method: GET
path: "/Evolve/Visits"
tags: ["Evolve"]
---

# Get EVOLVE Visits

`GET /Evolve/Visits`

**Requires permissions:** *AcademicStaff* or *AcademicSupport* or *StudentFacing*

Converts the EVOLVE visits XML API into JSON with optional paging, sorting and filtering using the same `filter` and `sort` query parameters as the rest of the Panoptic API.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `includes` string[], nullable
- `sort` string, nullable
- `filter` string, nullable
- `sDate` string, nullable
- `eDate` string, nullable
- `id` string, nullable

## Response `200`

Success

- GetEvolveVisitsResponse
  - `systemId` string, nullable
  - `timestamp` string, date-time, nullable
  - `filterApplied` string, nullable
  - `upstreamEvents` integer
  - `visits` EvolveVisit[]
    - `id` integer
    - `dateId` integer
    - `ouId` string, nullable
    - `ou` string, nullable
    - `type` string, nullable
    - `status` integer, nullable
    - `name` string, nullable
    - `lav` boolean
    - `residential` boolean
    - `overseas` boolean
    - `adventurousExternalProvider` boolean
    - `adventurousStaffLed` boolean
    - `dayVisit` boolean
    - `onsite` boolean
    - `startDate` string, date, nullable
    - `startTime` string, nullable
    - `endDate` string, date, nullable
    - `endTime` string, nullable
    - `participantUpns` string[]
    - `leaderId` integer, nullable
    - `leaderMisId` string, nullable
    - `leaderName` string, nullable
    - `staffUserIds` integer[]
    - `staffNames` string[]
    - `staffMisIds` string[]
  - `meta` Meta
    - `page` integer
    - `pageSize` integer
    - `total` integer

## Other responses

- `400` — Invalid filter or sort
- `401` — Unauthorized
- `403` — Forbidden
- `500` — EVOLVE API key is not configured or upstream request failed

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/28344aa564b4/schema)