org.passingreads.book.getRegistrationHints

passingreads.org

Documentation

Resolve the community's best guess at which publication an unregistered book is, from registration hints. Returns the publicationId suggested by the most hinters, ties broken by the earliest hint, so the registration flow can pre-fill and skip the search step.

main query

Resolve the community's best guess at which publication an unregistered book is, from registration hints. Returns the publicationId suggested by the most hinters, ties broken by the earliest hint, so the registration flow can pre-fill and skip the search step.

Parameters

bookId string Required

The book's ID (as defined on its QR Code).

Output

Encodingapplication/json
publicationId string Optional

The most-hinted Open Library Edition ID for this bookId (ties broken by the earliest hint). Absent when no one has hinted this book.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
The book's ID (as defined on its QR Code).
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "properties": {
        "publicationId": {
          "type": "string",
          "description": "The most-hinted Open Library Edition ID for this bookId (ties broken by the earliest hint). Absent when no one has hinted this book."
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "bookId"
    ],
    "properties": {
      "bookId": {
        "type": "string",
        "description": "The book's ID (as defined on its QR Code)."
      }
    }
  },
  "description": "Resolve the community's best guess at which publication an unregistered book is, from registration hints. Returns the publicationId suggested by the most hinters, ties broken by the earliest hint, so the registration flow can pre-fill and skip the search step."
}

Lexicon Garden

@