---
title: "GET /api/sheets/ref/{ref}"
method: GET
path: "/api/sheets/ref/{ref}"
tags: ["Sheets"]
---

# GET /api/sheets/ref/{ref}

`GET /api/sheets/ref/{ref}`

Returns public Sheets that cite a given Sefaria ref.

## Path parameters

- `ref` string, required

## Response `200`

Successful Response

- SheetsJSON[]
  - `owner` integer — the Sefaria User ID of the sheet's owner.
  - `id` string — The `id` of the sheet. This is used in the URL to retrieve sheets, for example, a sheet with an `id` of 1, would be accessible on [Sefaria](sefaria.org) at [sefaria.org/sheets/1](sefaria.org/sheets/1).
  - `public` boolean — Is this sheet public.
  - `title` string — Title of the Source Sheet.
  - `sheetUrl` string, nullable — URL to this source sheet.
  - `anchorRef` string — A string representing a citation to a Jewish text. A valid `Ref` consists of a title string followed optionally by a section string or a segment string. A title string is any one of the known text titles or title variants in the Sefaria Database.
  - `anchorRefExpanded` Ref[], nullable — An array containing the individual segments `Ref`s which comprise the `anchorRef`. Example 1: Ranged `Ref` If the `anchorRef` is `Genesis 2:14-16`, the `anchorRefExpanded` is `["Genesis 2:14", "Genesis 2:15", "Genesis 2:16"]`. Example 2: Segment Ref If the `anchorRef` itself is a segment `Ref`, the `anchorRefExpanded` will contain that identical value. For example, `anchorRef` of `Genesis 2:11` will have an `anchorRefExpanded` of `["Genesis 2:11"]`
  - `options` object, nullable — A JSON object containing document level options related to how this source sheet should be displayed in Sefaria's Source Sheet editor.
    - `numbered` number — Should the sources be automatically numbered in the Sefaria editor view
    - `boxed` union — Should the sources be boxed on the page in the Sefaria editor view
      - boolean
      - number
    - `assignable` union — Is this source sheet an assignment for students in the Sefaria editor view
      - boolean
      - number
    - `bsd` union — Should the source sheet include בס"ד at the top of the page in the Sefaria editor view
      - boolean
      - number
    - `language` 'bilingual' | 'hebrew' | 'english' — Default display language of the source sheet in the Sefaria editor view
    - `layout` string — Default display layout of the source sheet in the Sefaria editor view
    - `langLayout` string — Default display side of the language in a bilingual side-by-side view in the Sefaria editor view
    - `divineNames` string — Should the Tetragrammaton (Shem Hashem) and other variants of the divine name be replaced, and if so in what form?
    - `highlightMode` integer
    - `collaboration` string
  - `collectionTOC` object, nullable
  - `ownerName` string, nullable — Name of the owner of the sheet.
  - `via` string, nullable — Some source sheets are made by copying another users. If this is one of them, the original owner's user ID will be listed here.
  - `viaOwnerName` string, nullable — Some source sheets are made by copying another users. If this is one of them, the original owner's display name will be listed here.
  - `assignerName` string, nullable — Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets the name of the assigner will be found here.
  - `viaOwnerProfileUrl` string, nullable — Some source sheets are made by copying another users. If this is one of them, the path to the original owner's profile page will be listed here.
  - `assignerProfileUrl` string, nullable — Some source sheets are created as assignments by a teacher to be completed by students. If this is one of those sheets this will be the URL path to their profile.
  - `ownerProfileUrl` string, nullable — The URL Path that will link to a user's profile on the Sefaria site.
  - `ownerImageUrl` string, nullable — Sheet owner image.
  - `status` 'public' | 'unlisted' — a string indicating whether the sheet is `public` or `unlisted`
  - `views` integer — Number of source sheet views.
  - `topics` SheetTopicJSON[], nullable — Topics linked to the source sheet.
    - `slug` string — Slug of the topic
    - `asTyped` string — How the user typed the topic
    - `he` string — Hebrew topic title
    - `en` string — English topic title
  - `likes` unknown[], nullable — An array of user IDs who have favorited or liked this source sheet.
    - unknown
  - `summary` string, nullable — A user generated description of the source sheet
  - `attribution` string, nullable — Some source sheets are made by copying another users. If so, an attribution field will be created and displayed here.
  - `is_featured` boolean, nullable — Previously a source sheet flagged with `is_featured` would be promoted throughout the site in various places. This behavior was removed in 2022 but some of the data remains.
  - `category` string, nullable — This will always return `Sheets`
  - `type` string, nullable

---

[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)