---
title: "Nearest passages of the other works for one unit of a work"
method: GET
path: "/works/{work}/{ref}/work-parallels"
tags: ["Works"]
---

# Nearest passages of the other works for one unit of a work

`GET /works/{work}/{ref}/work-parallels`

## Request

- Base URL: `https://api.urantia.dev`
- URL: `https://api.urantia.dev/works/{work}/{ref}/work-parallels`
- Auth: none required

The 10 chunks of the other works and of the Bible that are closest in meaning to the chunk that holds this unit. The reference must name one unit of a text (not of the Bible). **These parallels are semantic, not curated.** They do not claim that two texts teach the same thing, or that one drew on the other.

## Path parameters

- `work` string, required: "bible", or a work id such as "bhagavad-gita" (its ref prefix also works: "bg").
- `ref` string, required: A unit (`John 3:16`, `2.47`, `Dhp 183`), a short range (`John 3:16-18`, `2.47-49`), or a whole chapter (`John 3`, `2`).

## Response `200`

The unit, its chunk, and the nearest chunks of the other works

- object
  - `data` object, required
    - `work` object, required
      - `id` string, required
      - `title` string, required
      - `tradition` string, required
    - `reference` string, required: "John 3:16", "Dhp 183", "BG 2.47-49" (a chunk in semantic search).
    - `text` string, required
    - `url` string, nullable, required: The public page that holds the text, or null.
    - `chunk` object, required
      - `label` string, required: The chunk that holds the unit: "Dhp 21-23".
      - `references` string[], required: Each unit of the chunk, in order.
    - `parallels` object[], required: Up to 10 chunks of the other works and of the Bible, nearest first. Empty when none are stored.
      - `work` object, required
        - `id` string, required
        - `title` string, required
        - `tradition` string, required
      - `reference` string, required: The chunk of the other work: "Quran 2.255-257", "Genesis 1:1-2".
      - `text` string, required
      - `url` string, nullable, required: The public page that holds the text, or null.
      - `similarity` number, required: Cosine similarity of the two chunks (text-embedding-3-large).

## Other responses

- `400`: Invalid request
- `404`: Work or reference not found
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2026-10-24** `cf0765043a4e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/urantia/apis/urantia-papers-api/changes/works/:work/:ref/work-parallels/get.md)

---

[API](https://skmtc.dev/urantia/apis/urantia-papers-api.md) - [All operations](https://skmtc.dev/urantia/apis/urantia-papers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/urantia/apis/urantia-papers-api/revisions/d046ecd9b449?raw)
