---
title: "GET /api/passages/{refs}"
method: GET
path: "/api/passages/{refs}"
tags: ["Text"]
---

# GET /api/passages/{refs}

`GET /api/passages/{refs}`

Maps each requested ref to the canonical passage that contains it. This endpoint is particularly useful for passages of Talmud, as it maps a ref for a single page to the full sugya boundary. It can also be used for Tanakh texts, where a verse maps to its correlating parashah. Pass a pipe-delimited list of refs.

## Path parameters

- `refs` string, required

## Response `200`

Successful Response

- PassagesJSON — A map keyed by the requested Sefaria ref. Each value is the canonical passage ref that contains it — for Tanakh a parasha-style passage, for Mishnah a chapter passage, for Talmud a full sugya boundary.

---

[API](https://skmtc.net/sefaria/apis/sefaria-api.md) · [All operations](https://skmtc.net/sefaria/apis/sefaria-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sefaria/sefaria-api/revisions/d29296717011/schema)
