{"openapi":"3.1.0","info":{"title":"Dartabase API","version":"1","description":"REST API for artwork, artist, institution, and exhibition metadata. 15,000+ records from 29 open-access museum collections.","contact":{"email":"institutions@dartabase.com"},"license":{"name":"See /terms","url":"https://dartabase.art/terms"}},"servers":[{"url":"https://dartabase.art/api/v1","description":"Production"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Dartabase API key (dbk_...). Omit for free-tier access."}},"schemas":{"ArtworkSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"artist":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"date":{"type":"string","nullable":true},"medium":{"type":"string","nullable":true},"dimensions":{"type":"string","nullable":true},"institution":{"type":"object","nullable":true,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"image_url":{"type":"string","format":"uri","nullable":true},"image_license":{"type":"string","nullable":true},"source":{"type":"string"},"source_id":{"type":"string","nullable":true},"source_url":{"type":"string","format":"uri","nullable":true},"cite_url":{"type":"string","format":"uri"}}},"ArtworkFull":{"allOf":[{"$ref":"#/components/schemas/ArtworkSummary"},{"type":"object","properties":{"materials":{"type":"string","nullable":true},"cultural_notice":{"type":"boolean","nullable":true},"citations":{"type":"object","properties":{"chicago":{"type":"string"},"mla":{"type":"string"},"apa":{"type":"string"}}}}}]},"ArtistFull":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"nationality":{"type":"string","nullable":true},"birth_year":{"type":"integer","nullable":true},"death_year":{"type":"integer","nullable":true},"bio":{"type":"string","nullable":true},"wikidata_id":{"type":"string","nullable":true},"artworks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"date":{"type":"string","nullable":true}}}},"artwork_count":{"type":"integer"}}},"InstitutionFull":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"city":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"website_url":{"type":"string","format":"uri","nullable":true},"artworks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"date":{"type":"string","nullable":true}}}},"artwork_count":{"type":"integer"}}},"Error":{"type":"object","properties":{"error":{"type":"string"}}},"Meta":{"type":"object","properties":{"page":{"type":"integer"},"perPage":{"type":"integer"},"total":{"type":"integer"}}}}},"paths":{"/artworks":{"get":{"operationId":"listArtworks","summary":"List artworks","description":"Paginated list of artworks. Supports full-text search and facet filters.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Full-text search query"},{"name":"page","in":"query","schema":{"type":"integer","default":1},"description":"Page number"},{"name":"decade","in":"query","schema":{"type":"string"},"description":"Decade filter, e.g. 1980s"},{"name":"institution","in":"query","schema":{"type":"string"},"description":"Institution name (partial match)"},{"name":"hasImage","in":"query","schema":{"type":"boolean"},"description":"Return only records with images"},{"name":"medium","in":"query","schema":{"type":"string","enum":["Painting","Print","Drawing","Photography","Sculpture","Ceramics","Textile"]},"description":"Medium bucket"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ArtworkSummary"}},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/artworks/{id}":{"get":{"operationId":"getArtwork","summary":"Get artwork","description":"Single artwork by Dartabase UUID. Includes pre-built citations.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ArtworkFull"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/artists/{id}":{"get":{"operationId":"getArtist","summary":"Get artist","description":"Single artist by Dartabase UUID with their works.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ArtistFull"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/institutions/{id}":{"get":{"operationId":"getInstitution","summary":"Get institution","description":"Single institution by Dartabase UUID with held works.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/InstitutionFull"}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}