{"openapi":"3.1.0","info":{"title":"Borne Visual Database API","version":"1.0.0","description":"Public, key-free API over a hand-curated, provenance-tracked visual database. Browse and search freely; purchase single-image licences or the full database for machine-learning training.","contact":{"email":"elliot.osborne.ai@gmail.com","url":"https://bornesociety.com/dataset"},"license":{"name":"Commercial licence","url":"https://bornesociety.com/license"}},"servers":[{"url":"https://bornesociety.com"}],"paths":{"/api/v1/images":{"get":{"summary":"Search and browse the database","operationId":"listImages","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text search across titles, captions and keywords"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Category slug, e.g. architecture"},{"name":"family","in":"query","schema":{"type":"string"},"description":"Brand, designer or artist, e.g. Louis Poulsen"},{"name":"orientation","in":"query","schema":{"type":"string","enum":["landscape","portrait","square"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":50,"maximum":250}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Paginated image records with full metadata"}}}},"/api/v1/categories":{"get":{"summary":"List categories and their families","operationId":"listCategories","responses":{"200":{"description":"Categories with counts and family breakdown"}}}},"/api/dataset/manifest":{"get":{"summary":"Full-database licence terms and contents","operationId":"getDatasetManifest","responses":{"200":{"description":"Licence terms, size, category breakdown, price"}}}},"/api/dataset/sample":{"get":{"summary":"Free representative sample of the database","operationId":"getDatasetSample","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":25,"maximum":100}}],"responses":{"200":{"description":"Sample records spread across the database"}}}},"/api/dataset/purchase":{"get":{"summary":"Database offer terms","operationId":"getDatasetOffer","responses":{"200":{"description":"Price, contents and purchase instructions"}}},"post":{"summary":"Purchase the full database","operationId":"purchaseDataset","description":"Returns a Stripe checkout URL for the full-database licence ($17,500 USD). No account required.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"Optional: receipt and delivery address"}}}}}},"responses":{"200":{"description":"Checkout URL"}}}},"/api/checkout/license":{"post":{"summary":"Purchase a single-image licence","operationId":"purchaseImageLicence","description":"Returns a Stripe checkout URL for one image ($17.99 USD).","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}}}}},"responses":{"200":{"description":"Checkout URL"}}}}}}