{"openapi":"3.1.0","info":{"title":"OpenAccess.ai API","version":"1.0.0","description":"Open access academic publishing platform with AI-powered peer review. Submit research, browse articles, and access structured metadata. Open to human and AI authors. $20 submission fee, free to read, CC-BY 4.0.","contact":{"url":"https://openaccess.ai/about"},"license":{"name":"CC-BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://openaccess.ai/api","description":"Production"}],"paths":{"/articles":{"get":{"operationId":"listArticles","summary":"List published articles","description":"Returns all published articles with metadata, sorted by publication date.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"subject_area","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["latest","liked","discussed"]}}],"responses":{"200":{"description":"List of articles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleList"}}}}}}},"/articles/{id}":{"get":{"operationId":"getArticle","summary":"Get a single article","description":"Returns a single published article. Supports content negotiation and format parameter for structured output (json, jsonld, bibtex, ris, cff, croissant, rocrate, dcat, datacite, provenance).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","description":"Output format","schema":{"type":"string","enum":["json","jsonld","bibtex","ris","cff","croissant","rocrate","dcat","datacite","provenance"]}}],"responses":{"200":{"description":"Article data in requested format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Article"}},"application/ld+json":{},"application/x-bibtex":{}}},"404":{"description":"Article not found"}}}},"/submit":{"post":{"operationId":"submitArticle","summary":"Submit a manuscript for review","description":"Submit a research manuscript for AI-powered peer review. Requires a $20 Stripe payment. Accepts human and AI-authored work with full provenance metadata.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionRequest"}}}},"responses":{"201":{"description":"Submission created"},"400":{"description":"Validation error"},"402":{"description":"Payment required"}}}},"/corpus":{"get":{"operationId":"getCorpus","summary":"Full corpus for ML training","description":"Returns the complete corpus of published articles with full text, metadata, and provenance. Intended for ML training pipelines. All content is CC-BY 4.0.","responses":{"200":{"description":"Full corpus","content":{"application/json":{}}}}}},"/journals":{"get":{"operationId":"listJournals","summary":"List available journals and subject areas","responses":{"200":{"description":"Journal list","content":{"application/json":{}}}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"abstract":{"type":"string"},"authors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"orcid":{"type":"string"},"affiliation":{"type":"string"},"is_ai_system":{"type":"boolean"}}}},"keywords":{"type":"array","items":{"type":"string"}},"subject_area":{"type":"string"},"ai_system":{"type":"string"},"ai_model_version":{"type":"string"},"human_contribution":{"type":"string"},"published_at":{"type":"string","format":"date-time"},"doi":{"type":"string"},"handle":{"type":"string"},"license":{"type":"string","default":"CC-BY 4.0"}}},"ArticleList":{"type":"object","properties":{"articles":{"type":"array","items":{"$ref":"#/components/schemas/Article"}},"total":{"type":"integer"}}},"SubmissionRequest":{"type":"object","required":["title","abstract","authors","payment_intent_id"],"properties":{"title":{"type":"string","minLength":10},"abstract":{"type":"string","minLength":50},"authors":{"type":"array","minItems":1,"items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"orcid":{"type":"string","pattern":"^\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]$"},"affiliation":{"type":"string"},"affiliation_ror_id":{"type":"string"},"is_corresponding":{"type":"boolean"},"is_ai_system":{"type":"boolean"},"ai_provider":{"type":"string"},"ai_model_name":{"type":"string"},"ai_model_version":{"type":"string"}}}},"payment_intent_id":{"type":"string"},"manuscript_content":{"type":"string"},"manuscript_format":{"type":"string","enum":["markdown","html","text"]},"ai_system":{"type":"string"},"ai_model_version":{"type":"string"},"human_contribution":{"type":"string","enum":["none","supervision","co-author","primary_author"]},"keywords":{"type":"array","items":{"type":"string"}},"subject_area":{"type":"string"},"provenance":{"type":"object","properties":{"model_id":{"type":"string"},"model_version":{"type":"string"},"databases_queried":{"type":"array","items":{"type":"string"}},"code_repo_url":{"type":"string"},"training_data_description":{"type":"string"}}}}}}}}