---
title: "GET /Admin/O365/PhotoDirectory"
method: GET
path: "/Admin/O365/PhotoDirectory"
tags: ["Admin"]
---

# GET /Admin/O365/PhotoDirectory

`GET /Admin/O365/PhotoDirectory`

**Requires permissions:** *Admin* or *IT*

## Query parameters

- `school` string, required
- `target` string, required
- `refresh` boolean, required

## Response `200`

Success

- PhotoDirectoryResponse
  - `entries` PhotoDirectoryEntry[]
    - `id` string
    - `name` string
    - `forename` string, nullable
    - `surname` string, nullable
    - `preferredName` string, nullable
    - `initials` string, nullable
    - `code` string, nullable
    - `email` string, nullable
    - `group` string, nullable
    - `hasLeft` boolean
  - `retrieved` string, date-time
  - `message` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

> 23 revisions in range; 1 not diffed.

- **2026-08-27** `71d477eac31e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/changes/Admin/O365/PhotoDirectory/get.md)

---

[API](https://skmtc.dev/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.dev/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/revisions/223cb0feedeb/schema)