---
title: "Paragraphs and passages that are each other's best match"
method: GET
path: "/scriptures/insights/pairs"
tags: ["Scriptures"]
---

# Paragraphs and passages that are each other's best match

`GET /scriptures/insights/pairs`

## Request

- Base URL: `https://api.urantia.dev`
- URL: `https://api.urantia.dev/scriptures/insights/pairs`
- Auth: none required

A Urantia paragraph and a passage where each is the other's closest match in that text, under both text-embedding-3-large and text-embedding-3-small. These are the most stable links in the data. Ranked by similarity. Filter with `corpus` (a corpus name or `bible`).

Scores come from the nine world religions texts and the World English Bible. For each text, a paragraph's best match becomes a percentile within that text, after an adjustment for paragraph length. The texts are not independent votes: a paragraph that sounds devotional tends to score well in all of them. These are measures of closeness in meaning by an embedding model, not claims about the teachings.

## Query parameters

- `corpus` string: A corpus id, slug, or ref prefix, or `bible`
- `excludeBible` 'true' | 'false': `true` leaves out the Bible, which has most of the mutual pairs
- `minLength` integer, nullable: Leave out paragraphs shorter than this many characters. Headings and fragments score unreliably
- `page` integer, nullable
- `limit` integer

## Response `200`

Mutual pairs

- object
  - `data` object[], required
    - `paragraph` object, required
      - `id` string, required
      - `standardReferenceId` string, required
      - `paperId` string, required
      - `paperTitle` string, required
      - `sectionTitle` string, nullable, required
      - `text` string, required
    - `corpus` object, required
      - `id` string, required
      - `slug` string, required
      - `religion` string, required
      - `title` string, required
      - `translator` string, required
      - `year` integer, required
      - `refPrefix` string, required
      - `urantiaSection` string, nullable, required: The Paper 131 section headed with this religion, or null when Paper 131 has no such heading
    - `passage` object, required
      - `chunkId` string, required
      - `reference` string, required
      - `text` string, required
    - `similarity` number, required: text-embedding-3-large cosine similarity
    - `similaritySmall` number, required: text-embedding-3-small cosine similarity
  - `meta` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required

## Other responses

- `400`: Invalid request
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2026-10-08** `0e36cd11b340`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/urantia/apis/urantia-papers-api/changes/scriptures/insights/pairs/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)