{"openapi":"3.1.0","info":{"title":"Tollfair catalogue","version":"0.1.0","description":"Read the Tollfair catalogue of data APIs. Metadata only."},"servers":[{"url":"https://www.tollfair.com"}],"paths":{"/catalog.json":{"get":{"operationId":"listDatasets","summary":"List catalogue datasets","parameters":[{"name":"country","in":"query","schema":{"type":"string","enum":["UK","Global","Africa"]}},{"name":"category","in":"query","schema":{"type":"string","enum":["Companies","Finance","Health and care","Property","Local","Environment","Economy","Transport","Research"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["submitted","listed","claimed"]}},{"name":"source","in":"query","schema":{"type":"string","enum":["primary","aggregate","derivative"]}},{"name":"sort","in":"query","schema":{"type":"string","enum":["stars"]}}],"responses":{"200":{"description":"Catalogue","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"datasets":{"type":"array","items":{"$ref":"#/components/schemas/Dataset"}}}}}}}}}}},"components":{"schemas":{"Dataset":{"type":"object","properties":{"key":{"type":"string","example":"companies-house/company-register"},"name":{"type":"string"},"summary":{"type":"string"},"provider":{"type":"string"},"category":{"type":"string","enum":["Companies","Finance","Health and care","Property","Local","Environment","Economy","Transport","Research"]},"country":{"type":"string"},"licence":{"type":"string"},"sourceType":{"type":"string","enum":["primary","aggregate","derivative"]},"status":{"type":"string","enum":["submitted","listed","claimed"]},"badge":{"type":"string"},"docsUrl":{"type":["string","null"]},"stars":{"type":"integer"},"dq":{"description":"Data Quality rating. null until the listing has been tested; none are issued yet.","oneOf":[{"type":"null"},{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100,"description":"Weighted average of the six dimension scores"},"band":{"type":"string","enum":["A","B","C","D","E"]},"dimensions":{"type":"object","properties":{"provenance":{"type":"integer","minimum":0,"maximum":100},"freshness":{"type":"integer","minimum":0,"maximum":100},"accuracy":{"type":"integer","minimum":0,"maximum":100},"completeness":{"type":"integer","minimum":0,"maximum":100},"licence":{"type":"integer","minimum":0,"maximum":100},"reliability":{"type":"integer","minimum":0,"maximum":100}}},"testedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}}}]},"url":{"type":"string"},"markdown":{"type":"string"}}}}}}