---
name: synth-directory-api
description: Look up which synthesiser was used on which record, and propose sourced claims, through the Synth.Directory API.
version: 0.1.2
---

# Synth.Directory

A public reference of which synthesiser was used on which record - artist, record, instrument,
role and settings, each backed by a graded source. Run like Wikipedia: every claim is either
awaiting review or verified against a stated evidential standard, never presented as settled
until it is.

## Auth

Reading needs no token: every page, its markdown twin, the sitemaps and `/llms.txt` are open.
The JSON API and proposing new material both need a personal bearer token. Full steps:
[https://synth.directory/auth.md](https://synth.directory/auth.md) - in short, register at
`/register`, mint a token at `/me/tokens`, send it as `Authorization: Bearer sd_...`.

## Read endpoints (one example each)

- `GET /api/v1/claims?artist=New+Order&instrument=Moog` - search claims (instrument, role,
  status, sources, settings).
- `GET /api/v1/records?q=blue+monday&with=claims` - search records, with their claims.
- `GET /api/v1/artists?q=new+order` - search artists.
- `GET /api/v1/instruments?maker=Moog&kind=synth` - search instruments.
- `GET /api/v1/people?q=peter+hook` - search performers and producers.
- `GET /api/v1/search?q=moog+source` - artists, records and instruments together, 10 of each.

Full shapes: [https://synth.directory/api/v1/openapi.json](https://synth.directory/api/v1/openapi.json).

## Propose

`POST /api/v1/propose` with `{"kind": "...", ...}`. `kind` is one of: `artist`, `record`,
`claim`, `source`, `edit`, `credit`, `video`. Every proposal joins the human review queue -
nothing posted through this endpoint is auto-accepted, whatever its source grade.

## The evidential standard

- Grade A: the artist, producer or engineer speaking directly.
- Grade B: a reputable publication reporting it.
- Grade C: a community database or forum post.

Never propose a source as grade C alone to try to verify a claim - a claim needs one grade A
source, or two independent grade B sources, to reach VERIFIED; grade C is context only and
never enough by itself. See [https://synth.directory/standard](https://synth.directory/standard).

## Licence

Facts (an instrument, a role, a record, a year, a citation) are CC0: no rights reserved.
Contributor prose is CC BY 4.0.