{"openapi":"3.1.0","info":{"title":"Tangopedia API","version":"1","description":"Read-only. Every fact carries its source_url and batch_id."},"servers":[{"url":"https://tangopedia.app"}],"paths":{"/api/v1/pedia/{code}":{"get":{"operationId":"getPage","summary":"A page by its code","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","pattern":"^T[PDOVSNREBLKXCJGW][0-9a-z]{6}$"}}],"responses":{"200":{"description":"A Tangopedia page (contract tangopedia.v1): entity, claims (each with batch_id, source_url, retrieved_at), sources, related, media.","content":{"application/json":{"schema":{"type":"object"}}}},"301":{"description":"Merged into another code."},"404":{"description":"No such page."},"410":{"description":"Removed."}}}},"/api/v1/pedia/{kind}/{slug}":{"get":{"operationId":"getPageBySlug","summary":"A page by kind and slug","parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["orchestras","singers","songs","people","recordings"]}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A Tangopedia page (contract tangopedia.v1): entity, claims (each with batch_id, source_url, retrieved_at), sources, related, media.","content":{"application/json":{"schema":{"type":"object"}}}},"301":{"description":"Merged into another code."},"404":{"description":"No such page."},"410":{"description":"Removed."}}}},"/api/v1/truth":{"get":{"operationId":"askTruth","summary":"Ask truth: every value the sources give for a question, ranked (contract v1.2 ask.truth.v1, no envelope)","parameters":[{"name":"subject","in":"query","schema":{"type":"string"},"description":"A Tangopedia code or a name"},{"name":"predicate","in":"query","schema":{"type":"string","enum":["arranged_for","born_in","born_on","broadcast_on","commented_on","composed_by","dance_style","danced_at","debut_recording","depicted_in","described_as","died_in","died_on","dj_at","duration","era","era_membership","external_id","filmed_at","genre","held_at","in_lineup","influenced","joined","last_recording","led","led_by","left","located_in","lyrics_by","matrix_number","mentioned_in","named_for","occurred_at","open_from","open_until","organised_by","partnered_with","performed_at","played_in","played_tanda","premiered_at","published_at","quoted_in","recorded_in","released_on_label","same_person_as","sang_with","schedule_night","signature_recording","sung_by","won"]}},{"name":"at","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-\\d{2}(-\\d{2})?)?$"}},{"name":"place","in":"query","schema":{"type":"string"},"description":"A place code"},{"name":"q","in":"query","schema":{"type":"string"},"description":"Free text instead of subject/predicate"}],"responses":{"200":{"description":"ask.truth.v1: status single/agreed/disputed/resolved_by_admin/no_answer; best (null on no_answer) and alternatives, each with claim_ids and evidence.","content":{"application/json":{"schema":{"$ref":"https://tangotube.tv/schemas/ask.truth.v1.json"}}}},"422":{"description":"No subject, or an unknown predicate."}}}},"/mcp":{"post":{"operationId":"mcp","summary":"MCP (JSON-RPC 2.0, Streamable HTTP, stateless)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"A JSON-RPC reply."},"429":{"description":"More than 60 calls a minute from one address."}}}}}}