{"slug":"doaj-api","name":"DOAJ API","host":"doaj.org","site":"https://doaj.org","category":"data","docsUrl":null,"sources":[{"kind":"archive","url":"https://blog.doaj.org/2024/05/22/new-major-version-of-the-api-to-be-released/"},{"kind":"archive","url":"https://blog.doaj.org/2024/07/16/were-cutting-over-to-the-new-api/"}],"url":"https://www.okapi.bot/providers/doaj-api/","json":"https://www.okapi.bot/api/v1/providers/doaj-api.json","breakingChanges":[{"slug":"post-api-bulk-articles-changes-the-unversioned-path-now-serves-api-v4-not","api":"doaj-api","title":"POST /api/bulk/articles changes: the unversioned path now serves API v4, not backwards compatible","kind":"behaviour_change","outcome":"fails","model":null,"announcedAt":"2024-05-22","effectiveAt":"2024-07-18","scope":null,"calls":["POST /api/bulk/articles"],"method":"POST","path":"/api/bulk/articles","source":{"url":"https://blog.doaj.org/2024/07/16/were-cutting-over-to-the-new-api/","kind":"archive"},"quote":"As previously mentioned on this blog, we will migrate to the newest version of our API on Thursday 18th July. The v4 API will become the “current” API version and be available at /api AND /api/v4.","migration":"Send bulk article uploads in the v4 format to POST /api/v4/bulk/articles; v1 to v3 no longer accept bulk uploads.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:20:51.899Z","updatedAt":"2026-10-23T10:20:51.899Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/doaj-api/breaking-changes/post-api-bulk-articles-changes-the-unversioned-path-now-serves-api-v4-not/"},{"slug":"post-api-v1-bulk-articles-is-deprecated","api":"doaj-api","title":"POST /api/v1/bulk/articles is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-05-22","effectiveAt":null,"scope":null,"calls":["POST /api/v1/bulk/articles"],"method":"POST","path":"/api/v1/bulk/articles","source":{"url":"https://blog.doaj.org/2024/05/22/new-major-version-of-the-api-to-be-released/","kind":"archive"},"quote":"All previous API versions (v1, v2 and v3) will cease to support bulk article uploads, and if you wish to use this feature, you must use the v4 API.","migration":"Upload articles in bulk with the v4 API: POST /api/v4/bulk/articles.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:20:53.900Z","updatedAt":"2026-10-23T10:20:53.900Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/doaj-api/breaking-changes/post-api-v1-bulk-articles-is-deprecated/"},{"slug":"post-api-v2-bulk-articles-is-deprecated","api":"doaj-api","title":"POST /api/v2/bulk/articles is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-05-22","effectiveAt":null,"scope":null,"calls":["POST /api/v2/bulk/articles"],"method":"POST","path":"/api/v2/bulk/articles","source":{"url":"https://blog.doaj.org/2024/05/22/new-major-version-of-the-api-to-be-released/","kind":"archive"},"quote":"All previous API versions (v1, v2 and v3) will cease to support bulk article uploads, and if you wish to use this feature, you must use the v4 API.","migration":"Upload articles in bulk with the v4 API: POST /api/v4/bulk/articles.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:20:53.900Z","updatedAt":"2026-10-23T10:20:53.900Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/doaj-api/breaking-changes/post-api-v2-bulk-articles-is-deprecated/"},{"slug":"post-api-v3-bulk-articles-is-deprecated","api":"doaj-api","title":"POST /api/v3/bulk/articles is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-05-22","effectiveAt":null,"scope":null,"calls":["POST /api/v3/bulk/articles"],"method":"POST","path":"/api/v3/bulk/articles","source":{"url":"https://blog.doaj.org/2024/05/22/new-major-version-of-the-api-to-be-released/","kind":"archive"},"quote":"All previous API versions (v1, v2 and v3) will cease to support bulk article uploads, and if you wish to use this feature, you must use the v4 API.","migration":"Upload articles in bulk with the v4 API: POST /api/v4/bulk/articles.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:20:53.900Z","updatedAt":"2026-10-23T10:20:53.900Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/doaj-api/breaking-changes/post-api-v3-bulk-articles-is-deprecated/"}]}