{"openapi":"3.1.0","info":{"title":"Public Domain Check","version":"0.7.0","description":"US copyright / public-domain status for creative works. Paid endpoints use x402 (HTTP 402) with USDC; no API key."},"servers":[{"url":"https://public-domain-check-production.up.railway.app"}],"paths":{"/v1/pd-status":{"get":{"operationId":"checkPublicDomainStatus","summary":"Is this work in the US public domain? ($0.01 brief / $0.02 full, via x402)","parameters":[{"name":"title","in":"query","required":true,"description":"Title of the work. Alone is usually enough for 1923–1977 books.","schema":{"type":"string"}},{"name":"author","in":"query","required":false,"schema":{"type":"string"}},{"name":"year","in":"query","required":false,"description":"Year of first publication (inferred when omitted)","schema":{"type":"integer"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["book","periodical","musical_composition","sound_recording","film","drama","artwork","photograph","map","other"]}},{"name":"author_death_year","in":"query","required":false,"schema":{"type":"integer"}},{"name":"work_for_hire","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"published","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"creation_year","in":"query","required":false,"schema":{"type":"integer"}},{"name":"origin","in":"query","required":false,"schema":{"type":"string","enum":["us","foreign","unknown"]}},{"name":"format","in":"query","required":false,"description":"brief (default, cheaper) = status, date, confidence and a one-line reason; full = complete reasoning and records","schema":{"type":"string","enum":["brief","full"]}}],"responses":{"200":{"description":"Status result","content":{"application/json":{"example":{"query":{"title":"The Big Sleep","author":"Raymond Chandler","type":"book","publication_year":1939,"origin":"us"},"status":"in_copyright","confidence":"high","rule":"renewed_1929_1963","public_domain_date":"2035-01-01","as_of":"2026-11-13","jurisdiction":"US","reasoning":["Published 1939; works published 1929–1963 needed a renewal filed in the 28th year (1966–1967) to get the full 95-year term.","Found the original registration A125939 (1939-02-06) and its renewal R399023 (1966-12-12).","A matching renewal record was found, so the full 95-year term applies."],"caveats":["Some inputs were inferred (see inferred); pass them explicitly to override."],"inferred":{"publication_year":{"value":1939,"from":"registration A125939"},"origin":{"value":"us","from":"registration class (A125939)"}},"registration":{"title":"Big sleep.","author":"Chandler, Raymond","registration":{"id":"A125939","date":"1939-02-06","place_of_publication":null,"claimant":null,"foreign_class":false},"renewal":{"id":"R399023","date":"1966-12-12","claimants":[{"name":"Helga Greene","role":"executor"}]},"pub_year":1939,"match_score":1},"renewal_checked":true,"renewal_candidates":[],"other_registrations":[{"title":"Awake from the big sleep","author":"James H. Oliphant and Company, Inc.; Francis H. M. Kelly","registration":{"id":"A474102","date":"1973-10-09","place_of_publication":null,"claimant":"James H. Oliphant and Company, Inc.","foreign_class":false},"renewal":null,"pub_year":1973,"match_score":0.56}]}}}},"402":{"description":"Payment required (x402)"},"422":{"description":"More input needed; not charged"}},"x-payment":{"protocol":"x402","price":"$0.01 brief (default), $0.02 full","network":"eip155:8453"}}},"/v1/pd-status/batch":{"post":{"operationId":"checkPublicDomainStatusBatch","summary":"Check up to 50 works ($0.0075 each brief, $0.015 full, via x402)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["works"],"properties":{"works":{"type":"array","maxItems":50,"items":{"type":"object","required":["title"],"properties":{"title":{"type":"string"},"author":{"type":"string"},"year":{"type":"integer"},"type":{"type":"string","enum":["book","periodical","musical_composition","sound_recording","film","drama","artwork","photograph","map","other"]},"author_death_year":{"type":"integer"},"work_for_hire":{"type":"boolean"},"published":{"type":"boolean"},"creation_year":{"type":"integer"},"origin":{"type":"string","enum":["us","foreign","unknown"]},"format":{"type":"string","enum":["brief","full"]}}}}}}}}},"responses":{"200":{"description":"One result per work"},"402":{"description":"Payment required (x402)"}},"x-payment":{"protocol":"x402","price":"$0.0075 per work brief, $0.015 full","network":"eip155:8453"}}},"/v1/renewals/search":{"get":{"operationId":"searchCopyrightRenewals","summary":"Search US copyright renewal records ($0.01 via x402)","parameters":[{"name":"title","in":"query","required":false,"schema":{"type":"string"}},{"name":"author","in":"query","required":false,"schema":{"type":"string"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Matching renewal records"},"402":{"description":"Payment required (x402)"}},"x-payment":{"protocol":"x402","price":"$0.01","network":"eip155:8453"}}},"/v1/pd-rules":{"get":{"operationId":"copyrightRulesForYear","summary":"Which US copyright rule applies to a publication year (free)","parameters":[{"name":"year","in":"query","required":true,"description":"Year of first publication","schema":{"type":"integer"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["book","periodical","musical_composition","sound_recording","film","drama","artwork","photograph","map","other"]}},{"name":"author_death_year","in":"query","required":false,"schema":{"type":"integer"}},{"name":"work_for_hire","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK"}}}},"/v1/pd-status/sample":{"get":{"operationId":"sampleResponse","summary":"Free example of a paid response","responses":{"200":{"description":"OK"}}}},"/v1/public-domain-day":{"get":{"operationId":"publicDomainDay","summary":"What enters the US public domain on Jan 1 of a year (free)","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}}}}