---
title: "who is mentioned in the same stretch of a book as this person: the sections of the book are the columns, every tagged person has the sections in which they are mentioned"
method: GET
path: "/api/people/{id}/presence"
tags: ["GanjoorRelatedPerson"]
---

# who is mentioned in the same stretch of a book as this person: the sections of the book are the columns, every tagged person has the sections in which they are mentioned

`GET /api/people/{id}/presence`

## Request

- Base URL: `https://api.ganjoor.net` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ganjoor.net/api/people/{id}/presence`
- Auth: none declared

## Path parameters

- `id` integer, required

## Query parameters

- `masterCatId` integer

## Response `200`

OK

- GanjoorPresenceTimelineViewModel: the "who is mentioned in the same stretch of the book" view of one person: the sections of a book (its direct sub-categories - in the Shahnameh the reigns) are the columns, and every tagged person has a presence span from the first to the last section in which they are mentioned. Uses only the poem tags and the book's structure - no birth/death years and no assumed lifespans.
  - `rootId` integer: the person the view was opened for
  - `rootName` string, nullable: name of the person the view was opened for
  - `books` GanjoorPresenceBook[], nullable: the books (master categories) in which this person is tagged, most tagged first
    - `masterCatId` integer: master category id
    - `title` string, nullable: title
    - `tagCount` integer: number of the person's tags in it
  - `masterCatId` integer, nullable: the book shown (null when the person is not tagged anywhere)
  - `columns` GanjoorPresenceColumn[], nullable: the sections of the shown book, in book order
    - `catId` integer: category id
    - `title` string, nullable: title
  - `people` GanjoorPresencePerson[], nullable: everyone tagged in the shown book
    - `id` integer: person id
    - `name` string, nullable: name
    - `columns` integer[], nullable: sorted column indexes
    - `related` boolean: directly related to the chart's person by a recorded kinship or affiliation (listed even when the two never share a section, e.g. father and son in successive reigns)

## Other responses

- `400`: Bad Request

## Changes

- **2026-10-13** `afb4560919ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ganjoor/apis/rmuseum-api/changes/api/people/:id/presence/get.md)

---

[API](https://skmtc.dev/ganjoor/apis/rmuseum-api.md) - [All operations](https://skmtc.dev/ganjoor/apis/rmuseum-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ganjoor/apis/rmuseum-api/revisions/143b912b1085?raw)