List the journals visible to the current credentials.

Returns a list of {"path", "name"} objects. path is the value to pass as the journal parameter in the other tools.

Check whether the current credentials work, and who you are.

API token: OJS has no identity endpoint for a token — this tool reports ONLY whether authentication works at all, not who the user is (identity in the response is then None).

Login and password: identity carries the logged-in user's real data (id, username, fullName, roles, role_names).

Find submissions (articles) in a journal.

status: queued, published, declined, scheduled. stage: submission, external_review, editing, production. section: a list of section IDs (from list_sections). inactive_days: only submissions inactive for N days. sort_by: datePublished, dateSubmitted, lastActivity, lastModified, sequence, title. descending=True sorts descending (default). Dates in YYYY-MM-DD format. The date filter only applies to already-fetched pages of the result — see the date_filtering_incomplete field in the response.

Fetch the details of one submission (article) by its ID.

Includes a trimmed list of its publications (versions). The full content of one version is returned by get_publication, and review rounds by get_submission_reviews.

Fetch one version (publication) of a submission — full details.

A submission may have several versions (successive revisions after review) — find the publication ID in the result of get_submission. Unlike the trimmed list, this also returns the abstract, the full author list, keywords, the DOI, the page/ article number, and galleys — this version's ready-made files (PDF, HTML, etc.) with public links.

Fetch the list of files attached to a submission (all stages).

Every file has file_stage_name alongside the numeric stage code, e.g. review_file, copyedit, final, body_text.

Fetch the review rounds and reviewer assignments for a submission.

Returns review_rounds (this submission's successive rounds) and review_assignments (who is reviewing, at which stage, with what result).

Find a journal's issues.

published_only=True restricts to already-published issues, False to those still being prepared; omitting it returns both kinds. sort_by: datePublished, lastModified, seq, publishedIssues, unpublishedIssues, shelf. OJS decides the sort direction itself for each of these values — it cannot be reversed here.

Fetch the journal's current issue (the one featured on the home page).

Returns issue: None if the journal does not yet have a current issue set.

Fetch one issue of a journal by its ID.

Find a journal's sections, e.g. "Articles", "Reviews".

active_only=True skips disabled sections; omitting it returns all of them.

Find a journal's users by name/email, status, and role.

status: active (default), disabled, all. role: site_admin, manager, sub_editor, reviewer, assistant, author, reader, subscription_manager.

Find a journal's reviewers together with their review statistics.

status: active (default), disabled, all. Returns, among others, the count of active/completed/declined reviews, the average review completion time in days, and the reviewer's rating.

Publication view statistics — a ranking or a time series.

timeline=False (default): a ranking of publications by view count. timeline=True: the sum of views over time; interval: day or month. Dates date_from/date_to in YYYY-MM-DD format.

Aggregate editorial statistics for a journal (submission count, decisions, time to first decision, etc.) as a list of key/value pairs.

Dates date_from/date_to in YYYY-MM-DD format narrow the period; without them OJS computes statistics from the journal's inception.

Find the DOIs registered for a journal.

status: unregistered, submitted, registered, error, stale.

Call any OJS REST API endpoint outside the ready-made tools.

path is relative to api/v1, e.g. 'submissions/12/files'. The ojs://endpoints resource returns the list of endpoints. journal="index" reaches site-level endpoints. Without OJS_ALLOW_WRITES, only read requests (GET/HEAD) are allowed. With the flag — this tool does NOT enforce the field list from edit_publication_metadata; the only write safeguard here is the OJS_ALLOW_WRITES flag itself.