REST API - OJS (3.3)

Download OpenAPI specification:Download

This guide documents the REST API endpoints which can be accessed with this version of Open Journal Systems. It is a technical reference for software developers who wish to build custom interactions with the platform.

Please consult the REST API Usage Guide for an introduction to using the API or the Developer Documentation Hub for technical documentation on the software.

Breaking changes since v3.2

  • Major changes were made to how galleys are fetched and new endpoints were added for submission files. See the documentation for full details.

Submissions

Get a list of submissions.

See /submissions/{submissionId} for notes about submission properties.

query Parameters
assignedTo
Array of integers

Filter results by those assigned to one or more user ids. All users except managers and admins are automatically restricted to assigned submissions and do not need to pass this parameter.

count
integer
Default: 20

How many results to return in a single request. Max is 100.

daysInactive
integer

Filter the results by those which have not had activity for the last X days.

isIncomplete
boolean

Filter the results by those for which the author has not yet completed the submission process.

isOverdue
boolean

Filter the results by those for which a reviewer has missed a deadline.

issueIds
Array of integers

Filter the results by those with one or more publications assigned to an issue.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests. A count of 10 and offset of 15 will return results 15 to 25.

orderBy
string
Default: "dateSubmitted"
Enum: "dateSubmitted" "dateLastActivity" "lastModified" "title"

Order the results returned.

orderDirection
string
Default: "DESC"
Enum: "ASC" "DESC"

Return the results in ascending or descending order.

searchPhrase
string

Filter the results by a search phrase matched against the title and authors.

sectionIds
Array of integers

Filter the results by those with one or more publications assigned to a section.

status
Array of integers
Items Enum: 1 3 4 5

Filter results by one or more submission statuses. Must match the value of one of the STATUS_QUEUED, STATUS_SCHEDULED, STATUS_PUBLISHED or STATUS_DECLINED constants.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Create a new submission.

Request Body schema: application/json

Details about the submission that should be created.

contextId
integer
currentPublicationId
integer

Which publication is the latest published version.

dateLastActivity
string

The last time activity was recorded related to this submission.

dateSubmitted
string
id
integer
lastModified
string

The last time a modification was made to this submission or any of its associated objects.

locale
string

The primary language of this submission.

stageId
integer
Default: 1

The stage of the editorial workflow that this submission is currently in. One of the WORKFLOW_STAGE_ constants. Default is WORKFLOW_STAGE_SUBMISSION.

status
integer
Default: 1

Whether the submission is Published, Declined, Scheduled or Queued (still in the workflow). One of the STATUS_* constants. Default is STATUS_QUEUED.

submissionProgress
integer
Default: 1

This number tracks a submission's progress before it is submitted to the journal or press. After submission, it will be set to 0, indicating it is ready for an editor's consideration.

Responses

Request samples

Content type
application/json
{
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "stageId": 1,
  • "status": 1,
  • "submissionProgress": 1
}

Response samples

Content type
application/json
{
  • "_href": "string",
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "publications": [
    ],
  • "reviewAssignments": [
    ],
  • "reviewRounds": [
    ],
  • "stageId": 1,
  • "stages": [
    ],
  • "status": 1,
  • "statusLabel": "string",
  • "submissionProgress": 1,
  • "urlAuthorWorkflow": "string",
  • "urlEditorialWorkflow": "string",
  • "urlPublished": "string",
  • "urlWorkflow": "string"
}

Get a submission by ID.

  • Unpublished submissions are only returned for assigned participants, editors and admins.
  • abstract includes HTML markup.
  • pages is usually a string. But in some cases it may return an array of arrays. Each array contains two items: the start and end page. Example: [[25, 31], [45, 62]].
  • submissionProgress will be > 0 if the submission is incomplete.
  • stages, reviewRounds and reviewAssignments should only be returned for participants assigned to the submission.
  • reviewAssignments should only expose user-identifying information for editors and admins.
path Parameters
submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "string",
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "publications": [
    ],
  • "reviewAssignments": [
    ],
  • "reviewRounds": [
    ],
  • "stageId": 1,
  • "stages": [
    ],
  • "status": 1,
  • "statusLabel": "string",
  • "submissionProgress": 1,
  • "urlAuthorWorkflow": "string",
  • "urlEditorialWorkflow": "string",
  • "urlPublished": "string",
  • "urlWorkflow": "string"
}

Edit a submission.

path Parameters
submissionId
required
integer

Submission ID

Request Body schema: application/json

The details about the submission that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

contextId
integer
currentPublicationId
integer

Which publication is the latest published version.

dateLastActivity
string

The last time activity was recorded related to this submission.

dateSubmitted
string
id
integer
lastModified
string

The last time a modification was made to this submission or any of its associated objects.

locale
string

The primary language of this submission.

stageId
integer
Default: 1

The stage of the editorial workflow that this submission is currently in. One of the WORKFLOW_STAGE_ constants. Default is WORKFLOW_STAGE_SUBMISSION.

status
integer
Default: 1

Whether the submission is Published, Declined, Scheduled or Queued (still in the workflow). One of the STATUS_* constants. Default is STATUS_QUEUED.

submissionProgress
integer
Default: 1

This number tracks a submission's progress before it is submitted to the journal or press. After submission, it will be set to 0, indicating it is ready for an editor's consideration.

Responses

Request samples

Content type
application/json
{
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "stageId": 1,
  • "status": 1,
  • "submissionProgress": 1
}

Response samples

Content type
application/json
{
  • "_href": "string",
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "publications": [
    ],
  • "reviewAssignments": [
    ],
  • "reviewRounds": [
    ],
  • "stageId": 1,
  • "stages": [
    ],
  • "status": 1,
  • "statusLabel": "string",
  • "submissionProgress": 1,
  • "urlAuthorWorkflow": "string",
  • "urlEditorialWorkflow": "string",
  • "urlPublished": "string",
  • "urlWorkflow": "string"
}

Delete a submission.

Only journal managers and subeditors can make a request to this endpoint.

path Parameters
submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "string",
  • "contextId": 0,
  • "currentPublicationId": 0,
  • "dateLastActivity": "string",
  • "dateSubmitted": "string",
  • "id": 0,
  • "lastModified": "string",
  • "locale": "string",
  • "publications": [
    ],
  • "reviewAssignments": [
    ],
  • "reviewRounds": [
    ],
  • "stageId": 1,
  • "stages": [
    ],
  • "status": 1,
  • "statusLabel": "string",
  • "submissionProgress": 1,
  • "urlAuthorWorkflow": "string",
  • "urlEditorialWorkflow": "string",
  • "urlPublished": "string",
  • "urlWorkflow": "string"
}

Submissions / Files

Get a submission's files.

This will return all of a submission's files that the user is allowed to access, except review attachments and discussion files. A user is allowed to access different file stages depending on their stage assignment.

  • Managers, subeditors and assistants can access all file stages if they are assigned to the matching workflow stage. For example, an assistant assigned to the copyediting stage can access files in SUBMISSION_FILE_COPYEDIT and SUBMISSION_FILE_FINAL.
  • Authors are restricted to the SUBMISSION_FILE_SUBMISSION, SUBMISSION_FILE_REVIEW_REVISION, SUBMISSION_FILE_COPYEDIT and SUBMISSION_FILE_PROOF file stages. For example, an author with access to the copyediting stage will have access to SUBMISSION_FILE_COPYEDIT (copyedited files) but not SUBMISSION_FILE_FINAL (draft files).
  • Reviewers and readers are not allowed to access this endpoint.
  • Managers who are not assigned to the submission are allowed to access all file stages as though they are assigned to every workflow stage.
path Parameters
submissionId
required
integer

Submission ID

query Parameters
fileStages
Array of integers

Filter results by those submission files assigned to one or more file stage. One of the SUBMISSION_FILE_ constants.

reviewRoundIds
Array of integers

Filter results by those submission files assigned to one or more review rounds.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a new submission file.

A user is allowed to upload to different file stages depending on their stage assignments. See the description for GET /submission/{submissionId}/files above. Once a submission has been completed, authors are no longer allowed to upload to SUBMISSION_FILE_SUBMISSION. Authors are not allowed to upload to SUBMISSION_FILE_REVIEW_REVISION until revisions have been requested.

Request Body schema: multipart/form-data

Details about the submission file that should be created.

assocId
integer

Used with assocType to associate this file with an object such as a galley.

assocType
integer

Used with assocId to associate this file with an object such as a galley. One of the following constants: ASSOC_TYPE_SUBMISSION_FILE (dependent files), ASSOC_TYPE_REVIEW_ASSIGNMENT (files uploaded by a reviewer), ASSOC_TYPE_NOTE (files uploaded with a discussion), ASSOC_TYPE_REPRESENTATION (files uploaded to a galley or publication format), ASSOC_TYPE_REVIEW_ROUND (review files and revisions for a particular review round).

caption
string

A caption for this file. Used with artwork such as images.

copyrightOwner
string

The copyright owner of this file. Used with artwork such as images.

createdAt
string

The date this submission file object was created in the system. Set automatically by the software.

creator
object (LocaleObject)

Key/value pairs containing data stored by locale key.

credit
string

An attribution for this file, such as a photographer's name. Used with artwork such as images.

dateCreated
string

Public metadata about when this content was created. Used with supplementary files.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

file
string <binary>
fileId
integer
fileStage
integer
genreId
integer
language
string

The language of this file if it contains text. Used with supplementary files.

name
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publisher
object (LocaleObject)

Key/value pairs containing data stored by locale key.

source
object (LocaleObject)

Key/value pairs containing data stored by locale key.

sourceSubmissionFileId
integer

When a submission file is promoted from one stage to another, this property identifies the source file from which this file was promoted. Default: null.

sponsor
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subject
object (LocaleObject)

Key/value pairs containing data stored by locale key.

submissionId
integer
terms
string

Licensing terms for this file. Used with artwork such as images.

updatedAt
string

When this object was last updated.

uploaderUserId
integer
viewable
boolean

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "caption": "string",
  • "copyrightOwner": "string",
  • "createdAt": "string",
  • "creator": {
    },
  • "credit": "string",
  • "dateCreated": "string",
  • "dependentFiles": [
    ],
  • "description": {
    },
  • "documentType": "string",
  • "fileId": 0,
  • "fileStage": 0,
  • "genreId": 0,
  • "id": 0,
  • "language": "string",
  • "locale": "string",
  • "mimetype": "string",
  • "name": {
    },
  • "path": "string",
  • "publisher": {
    },
  • "revisions": [
    ],
  • "source": {
    },
  • "sourceSubmissionFileId": 0,
  • "sponsor": {
    },
  • "subject": {
    },
  • "submissionId": 0,
  • "terms": "string",
  • "updatedAt": "string",
  • "uploaderUserId": 0,
  • "url": "string",
  • "viewable": true
}

Get a submission file.

You must pass the correct stageId when requesting a file.

path Parameters
submissionFileId
required
integer

Submission File ID

submissionId
required
integer

Submission ID

query Parameters
stageId
required
integer

The workflow stage id of the requested file. For example, WORKFLOW_STAGE_ID_PRODUCTION.

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "caption": "string",
  • "copyrightOwner": "string",
  • "createdAt": "string",
  • "creator": {
    },
  • "credit": "string",
  • "dateCreated": "string",
  • "dependentFiles": [
    ],
  • "description": {
    },
  • "documentType": "string",
  • "fileId": 0,
  • "fileStage": 0,
  • "genreId": 0,
  • "id": 0,
  • "language": "string",
  • "locale": "string",
  • "mimetype": "string",
  • "name": {
    },
  • "path": "string",
  • "publisher": {
    },
  • "revisions": [
    ],
  • "source": {
    },
  • "sourceSubmissionFileId": 0,
  • "sponsor": {
    },
  • "subject": {
    },
  • "submissionId": 0,
  • "terms": "string",
  • "updatedAt": "string",
  • "uploaderUserId": 0,
  • "url": "string",
  • "viewable": true
}

Edit a submission file.

You must pass the correct stageId when editing a file.

path Parameters
submissionFileId
required
integer

Submission File ID

submissionId
required
integer

Submission ID

query Parameters
stageId
required
integer

The workflow stage id of the file to be edited. For example, WORKFLOW_STAGE_ID_PRODUCTION.

Request Body schema: application/json

The details about the submission file that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

assocId
integer

Used with assocType to associate this file with an object such as a galley.

assocType
integer

Used with assocId to associate this file with an object such as a galley. One of the following constants: ASSOC_TYPE_SUBMISSION_FILE (dependent files), ASSOC_TYPE_REVIEW_ASSIGNMENT (files uploaded by a reviewer), ASSOC_TYPE_NOTE (files uploaded with a discussion), ASSOC_TYPE_REPRESENTATION (files uploaded to a galley or publication format), ASSOC_TYPE_REVIEW_ROUND (review files and revisions for a particular review round).

caption
string

A caption for this file. Used with artwork such as images.

copyrightOwner
string

The copyright owner of this file. Used with artwork such as images.

createdAt
string

The date this submission file object was created in the system. Set automatically by the software.

creator
object (LocaleObject)

Key/value pairs containing data stored by locale key.

credit
string

An attribution for this file, such as a photographer's name. Used with artwork such as images.

dateCreated
string

Public metadata about when this content was created. Used with supplementary files.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

file
string <binary>
fileId
integer
fileStage
integer
genreId
integer
language
string

The language of this file if it contains text. Used with supplementary files.

name
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publisher
object (LocaleObject)

Key/value pairs containing data stored by locale key.

source
object (LocaleObject)

Key/value pairs containing data stored by locale key.

sourceSubmissionFileId
integer

When a submission file is promoted from one stage to another, this property identifies the source file from which this file was promoted. Default: null.

sponsor
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subject
object (LocaleObject)

Key/value pairs containing data stored by locale key.

submissionId
integer
terms
string

Licensing terms for this file. Used with artwork such as images.

updatedAt
string

When this object was last updated.

uploaderUserId
integer
viewable
boolean

Responses

Request samples

Content type
application/json
{
  • "assocId": 0,
  • "assocType": 0,
  • "caption": "string",
  • "copyrightOwner": "string",
  • "createdAt": "string",
  • "creator": {
    },
  • "credit": "string",
  • "dateCreated": "string",
  • "description": {
    },
  • "file": "string",
  • "fileId": 0,
  • "fileStage": 0,
  • "genreId": 0,
  • "language": "string",
  • "name": {
    },
  • "publisher": {
    },
  • "source": {
    },
  • "sourceSubmissionFileId": 0,
  • "sponsor": {
    },
  • "subject": {
    },
  • "submissionId": 0,
  • "terms": "string",
  • "updatedAt": "string",
  • "uploaderUserId": 0,
  • "viewable": true
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "caption": "string",
  • "copyrightOwner": "string",
  • "createdAt": "string",
  • "creator": {
    },
  • "credit": "string",
  • "dateCreated": "string",
  • "dependentFiles": [
    ],
  • "description": {
    },
  • "documentType": "string",
  • "fileId": 0,
  • "fileStage": 0,
  • "genreId": 0,
  • "id": 0,
  • "language": "string",
  • "locale": "string",
  • "mimetype": "string",
  • "name": {
    },
  • "path": "string",
  • "publisher": {
    },
  • "revisions": [
    ],
  • "source": {
    },
  • "sourceSubmissionFileId": 0,
  • "sponsor": {
    },
  • "subject": {
    },
  • "submissionId": 0,
  • "terms": "string",
  • "updatedAt": "string",
  • "uploaderUserId": 0,
  • "url": "string",
  • "viewable": true
}

Delete a submission file.

You must pass the correct stageId when deleting a file.

path Parameters
submissionFileId
required
integer

Submission File ID

submissionId
required
integer

Submission ID

query Parameters
stageId
required
integer

The workflow stage id of the file to be edited. For example, WORKFLOW_STAGE_ID_PRODUCTION.

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "caption": "string",
  • "copyrightOwner": "string",
  • "createdAt": "string",
  • "creator": {
    },
  • "credit": "string",
  • "dateCreated": "string",
  • "dependentFiles": [
    ],
  • "description": {
    },
  • "documentType": "string",
  • "fileId": 0,
  • "fileStage": 0,
  • "genreId": 0,
  • "id": 0,
  • "language": "string",
  • "locale": "string",
  • "mimetype": "string",
  • "name": {
    },
  • "path": "string",
  • "publisher": {
    },
  • "revisions": [
    ],
  • "source": {
    },
  • "sourceSubmissionFileId": 0,
  • "sponsor": {
    },
  • "subject": {
    },
  • "submissionId": 0,
  • "terms": "string",
  • "updatedAt": "string",
  • "uploaderUserId": 0,
  • "url": "string",
  • "viewable": true
}

Submissions / Participants

Get assigned participants.

Get the participants assigned to a submisssion.

path Parameters
submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get assigned participants by stage.

Get all participants assigned to a submission for a specific workflow stage, such as the review or copyediting stage.

path Parameters
stageId
required
integer

Stage ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Submissions / Publications

Get a submission's publications.

path Parameters
submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a publication.

Create a new publication for a submission.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Request Body schema: application/json

Details about the publication that should be created.

abstract
object (LocaleObject)

Key/value pairs containing data stored by locale key.

accessStatus
integer
Default: 0
categoryIds
Array of integers
citationsRaw
string

Optional metadata that contains references for works cited in this submission as raw text.

copyrightHolder
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightYear
integer

The copyright year for this publication.

coverage
object (LocaleObject)

Key/value pairs containing data stored by locale key.

object
datePublished
string
disciplines
Array of strings

Optional metadata that describes the submission's types of study or branches of knowledge.

hideAuthor
boolean
Default: false

Whether the contributor details should be displayed for this publication. Commonly used for editorial statements without individual authorship.

issueId
integer
keywords
Array of strings

Optional metadata, usually one- to three-word phrases that are used to indicate the main topics of a submission.

languages
Array of strings

Optional metadata that identifies the submission's primary language.

lastModified
string
licenseUrl
string

A URL to a webpage describing the license terms for this publication.

pages
string

The pages of the issue in which this article appears if it is published in a physical format.

prefix
object (LocaleObject)

Key/value pairs containing data stored by locale key.

primaryContactId
integer

Which contributor is the primary contact for this publication.

pub-id::publisher-id
string

A unique ID provided by the publisher. It will be used in the publication's URL path instead of the id when present.

rights
object (LocaleObject)

Key/value pairs containing data stored by locale key.

sectionId
integer
seq
integer
Default: 0
source
object (LocaleObject)

Key/value pairs containing data stored by locale key.

status
integer
Default: 1

Whether the publication is Queued (not yet scheduled for publication), Declined, Published or Scheduled (scheduled for publication at a future date). One of the STATUS_* constants. Default is STATUS_QUEUED.

subjects
Array of strings

Optional metadata that consists of keywords, key phrases or classification codes that describe the submission's topics.

submissionId
integer
subtitle
object (LocaleObject)

Key/value pairs containing data stored by locale key.

supportingAgencies
Array of strings

Optional metadata that indicates the source of research funding or other institutional support.

title
object (LocaleObject)

Key/value pairs containing data stored by locale key.

type
object (LocaleObject)

Key/value pairs containing data stored by locale key.

urlPath
string

An optional path to use in the URL instead of the ID.

version
integer

The version number of this publication. Version numbers should increment by one so that the third publication of a submission will have the version number 3. Version numbers should typically be set automatically and editorial staff should not be encouraged to modify them.

Responses

Request samples

Content type
application/json
{
  • "abstract": {
    },
  • "accessStatus": 0,
  • "categoryIds": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "hideAuthor": false,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "version": 0
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Get a publication.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Edit a publication.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Request Body schema: application/json

The details about the publication that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

abstract
object (LocaleObject)

Key/value pairs containing data stored by locale key.

accessStatus
integer
Default: 0
categoryIds
Array of integers
citationsRaw
string

Optional metadata that contains references for works cited in this submission as raw text.

copyrightHolder
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightYear
integer

The copyright year for this publication.

coverage
object (LocaleObject)

Key/value pairs containing data stored by locale key.

object
datePublished
string
disciplines
Array of strings

Optional metadata that describes the submission's types of study or branches of knowledge.

hideAuthor
boolean
Default: false

Whether the contributor details should be displayed for this publication. Commonly used for editorial statements without individual authorship.

issueId
integer
keywords
Array of strings

Optional metadata, usually one- to three-word phrases that are used to indicate the main topics of a submission.

languages
Array of strings

Optional metadata that identifies the submission's primary language.

lastModified
string
licenseUrl
string

A URL to a webpage describing the license terms for this publication.

pages
string

The pages of the issue in which this article appears if it is published in a physical format.

prefix
object (LocaleObject)

Key/value pairs containing data stored by locale key.

primaryContactId
integer

Which contributor is the primary contact for this publication.

pub-id::publisher-id
string

A unique ID provided by the publisher. It will be used in the publication's URL path instead of the id when present.

rights
object (LocaleObject)

Key/value pairs containing data stored by locale key.

sectionId
integer
seq
integer
Default: 0
source
object (LocaleObject)

Key/value pairs containing data stored by locale key.

status
integer
Default: 1

Whether the publication is Queued (not yet scheduled for publication), Declined, Published or Scheduled (scheduled for publication at a future date). One of the STATUS_* constants. Default is STATUS_QUEUED.

subjects
Array of strings

Optional metadata that consists of keywords, key phrases or classification codes that describe the submission's topics.

submissionId
integer
subtitle
object (LocaleObject)

Key/value pairs containing data stored by locale key.

supportingAgencies
Array of strings

Optional metadata that indicates the source of research funding or other institutional support.

title
object (LocaleObject)

Key/value pairs containing data stored by locale key.

type
object (LocaleObject)

Key/value pairs containing data stored by locale key.

urlPath
string

An optional path to use in the URL instead of the ID.

version
integer

The version number of this publication. Version numbers should increment by one so that the third publication of a submission will have the version number 3. Version numbers should typically be set automatically and editorial staff should not be encouraged to modify them.

Responses

Request samples

Content type
application/json
{
  • "abstract": {
    },
  • "accessStatus": 0,
  • "categoryIds": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "hideAuthor": false,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "version": 0
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Delete a publication.

Only journal managers and subeditors can make a request to this endpoint.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Create a new version of a publication.

Duplicate a publication, including author and galley records, in order to create a new version of a publication that can be edited.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Publish a publication.

If the publication is assigned to an issue that is not yet published, it will be scheduled for publication and the status will be set to STATUS_SCHEDULED. If the issue is already published, it will be published immediately and the status will be set to STATUS_PUBLISHED.

The publication will be validated against any publishing requirements before it is published and a 400 response will be returned if it fails validation.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Unpublish a publication.

path Parameters
publicationId
required
integer

Publication ID

submissionId
required
integer

Submission ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abstract": {
    },
  • "accessStatus": 0,
  • "authors": [
    ],
  • "authorsString": "string",
  • "authorsStringShort": "string",
  • "categoryIds": [
    ],
  • "citations": [
    ],
  • "citationsRaw": "string",
  • "copyrightHolder": {
    },
  • "copyrightYear": 0,
  • "coverImage": {
    },
  • "coverage": {
    },
  • "datePublished": "string",
  • "disciplines": [
    ],
  • "fullTitle": {
    },
  • "galleys": [
    ],
  • "hideAuthor": false,
  • "id": 0,
  • "issueId": 0,
  • "keywords": [
    ],
  • "languages": [
    ],
  • "lastModified": "string",
  • "licenseUrl": "string",
  • "locale": "string",
  • "pages": "string",
  • "prefix": {
    },
  • "primaryContactId": 0,
  • "pub-id::publisher-id": "string",
  • "rights": {
    },
  • "sectionId": 0,
  • "seq": 0,
  • "source": {
    },
  • "status": 1,
  • "subjects": [
    ],
  • "submissionId": 0,
  • "subtitle": {
    },
  • "supportingAgencies": [
    ],
  • "title": {
    },
  • "type": {
    },
  • "urlPath": "string",
  • "urlPublished": "string",
  • "version": 0
}

Issues

Get a list of issues.

Results are eordered by datePublished.

query Parameters
count
integer
Default: 20

How many results to return in a single request. Max is 100.

isPublished
boolean

Filter returned issues by those that have been published. Pass a false value to return only unpublished issues. Only administrators and journal managers are allowed to access unpublished issues.

numbers
string

Filter returned issues by those assigned a specific number.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests. A count of 10 and offset of 15 will return results 15 to 25.

orderBy
string
Default: "datePublished"
Enum: "datePublished" "lastModified" "seq"

Order the results returned.

orderDirection
string
Default: "DESC"
Enum: "ASC" "DESC"

Return the results in ascending or descending order.

searchPhrase
string

Filter the results by a search phrase matched against the title, description and year. It will also attempt to match search phrases using the localised issue identification. For example, in English a search for Vol. 1 No. 2 (2018) will match an issue with a volume of 1, a number of 2 and a year of 2018. The precise format differs for each language.

volumes
string

Filter returned issues by those in a specific volume.

years
string

Filter returned issues by those in a specific year.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get the current issue.

Responses

Response samples

Content type
application/json
{
  • "_href": "string",
  • "articles": [
    ],
  • "coverImageAltText": {
    },
  • "coverImageUrl": {
    },
  • "dateNotified": "string",
  • "datePublished": "string",
  • "description": {
    },
  • "doi": "string",
  • "galleys": [
    ],
  • "id": 0,
  • "identification": "string",
  • "isCurrent": true,
  • "lastModified": "string",
  • "number": "string",
  • "publishedUrl": "string",
  • "sections": [
    ],
  • "title": {
    },
  • "urlPath": "string",
  • "volume": 0,
  • "year": 0
}

Get an issue by ID.

If the issue has a custom section order, the seq property of each SectionSummary will reflect the sequence for that issue.

path Parameters
issueId
required
integer

Issue ID

Responses

Response samples

Content type
application/json
{
  • "_href": "string",
  • "articles": [
    ],
  • "coverImageAltText": {
    },
  • "coverImageUrl": {
    },
  • "dateNotified": "string",
  • "datePublished": "string",
  • "description": {
    },
  • "doi": "string",
  • "galleys": [
    ],
  • "id": 0,
  • "identification": "string",
  • "isCurrent": true,
  • "lastModified": "string",
  • "number": "string",
  • "publishedUrl": "string",
  • "sections": [
    ],
  • "title": {
    },
  • "urlPath": "string",
  • "volume": 0,
  • "year": 0
}

Users

Only admins, journal editors, and subeditors can access these endpoints.

Get a list of users.

query Parameters
assignedToSection
integer

Filter the results by those assigned as section editors to this section ID.

assignedToSubmission
integer

Filter results by those assigned to this submission ID.

assignedToSubmissionStage
integer

Filter results by those assigned to this submission stage. Will be ignored if no assignedToSubmission parameter exists.

count
integer
Default: 20

How many results to return in a single request. Max is 100.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests. A count of 10 and offset of 15 will return results 15 to 25.

orderBy
string
Default: "id"
Enum: "id" "familyName" "givenName"

Order the results returned.

orderDirection
string
Default: "DESC"
Enum: "ASC" "DESC"

Return the results in ascending or descending order.

roleIds
Array of integers

Filter the results by those who have one of these user role IDs.

searchPhrase
string

Filter the results by a search phrase matched against the userName, givenName, familyName, email, affiliation, biography and orcid.

status
string
Default: "active"
Enum: "active" "disabled" "all"

Filter results by active/disabled users.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Get a user by ID.

path Parameters
userId
required
integer

User ID

Responses

Response samples

Content type
application/json
{
  • "_href": "string",
  • "affiliation": {
    },
  • "authId": 0,
  • "authString": "string",
  • "billingAddress": "string",
  • "biography": {
    },
  • "country": "string",
  • "dateLastRegistered": "string",
  • "dateRegistered": "string",
  • "dateValidated": "string",
  • "disabled": true,
  • "disabledReason": "string",
  • "email": "string",
  • "familyName": {
    },
  • "fullName": "string",
  • "givenName": {
    },
  • "gossip": {
    },
  • "groups": [
    ],
  • "id": 0,
  • "interests": [
    ],
  • "mailingAddress": "string",
  • "mustChangePassword": true,
  • "orcid": "string",
  • "phone": "string",
  • "signature": {
    },
  • "url": "string",
  • "userName": "string"
}

Get a list of reviewers.

query Parameters
averageCompletion
integer

Filter results by those who complete a review assignment within X days on average.

count
integer
Default: 20

How many results to return in a single request. Max is 100.

daysSinceLastAssignment
string

Filter results by those who's last review was assigned at least X days ago. You can also pass a range as a string formatted as X-X.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests. A count of 10 and offset of 15 will return results 15 to 25.

orderBy
string
Default: "id"
Enum: "id" "familyName" "givenName"

Order the results returned.

orderDirection
string
Default: "DESC"
Enum: "ASC" "DESC"

Return the results in ascending or descending order.

reviewerRating
integer

Filter results by those who have an average review assignment rating of at least X (valid ratings are between 1 and 5).

reviewsActive
string

Filter results by those who have X review assignments currently in progress. You can also pass a range as a string formatted as X-X.

reviewsCompleted
string

Filter results by those who have completed at least X reviews. You can also pass a range as a string formatted as X-X.

reviewStage
integer

Filter results by reviewers for one of the review stages in the workflow. Must be one of WORKFLOW_STAGE_ID_INTERNAL_REVIEW or WORKFLOW_STAGE_ID_EXTERNAL_REVIEW. In OJS, the review stage is WORKFLOW_STAGE_ID_EXTERNAL_REVIEW.

searchPhrase
string

Filter the results by a search phrase matched against the userName, givenName, familyName, email, affiliation, biography, orcid, interests, and gossip.

status
string
Default: "active"
Enum: "active" "disabled" "all"

Filter results by active/disabled users.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Contexts

Only admins and journal managers can access these endpoints.

Get a list of contexts.

Get an array of the journals (OJS), presses (OMP) or preprint servers (OPS) hosted on this site.

query Parameters
count
type
Default: 20

How many results to return in a single request. Max is 100.

isEnabled
string

Filter results by enabled/disabled contexts. Any truthy or falsey value will get enabled/disabled contexts. Leave this parameter out to get all contexts.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests.

searchPhrase
string

Filter results by a search phrase matched against the name, description, acronym, or abbreviation.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Create a new context.

Create a new journal (OJS), press (OMP) or preprint server (OPS).

Request Body schema: application/json

Details about the context that should be created. The path field is required. The name is required in the site's primary locale.

abbreviation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

about
object (LocaleObject)

Key/value pairs containing data stored by locale key.

acronym
object (LocaleObject)

Key/value pairs containing data stored by locale key.

additionalHomeContent
object (LocaleObject)

Key/value pairs containing data stored by locale key.

agencies
string

Enable agencies metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

announcementsIntroduction
object (LocaleObject)

Key/value pairs containing data stored by locale key.

authorGuidelines
object (LocaleObject)

Key/value pairs containing data stored by locale key.

authorInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

citations
string

Enable citations metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

clockssLicense
object (LocaleObject)

Key/value pairs containing data stored by locale key.

competingInterests
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactAffiliation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactEmail
string
contactName
string
contactPhone
string
copyrightHolderOther
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightHolderType
string
copyrightNotice
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightYearBasis
string
Default: "issue"
coverage
string

Enable coverage metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

currency
string
customHeaders
object (LocaleObject)

Key/value pairs containing data stored by locale key.

dateFormatLong
object (LocaleObject)

Key/value pairs containing data stored by locale key.

dateFormatShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

datetimeFormatLong
object (LocaleObject)

Key/value pairs containing data stored by locale key.

datetimeFormatShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

defaultMetricType
string
defaultReviewMode
integer
Default: 2
delayedOpenAccessDuration
integer
delayedOpenAccessPolicy
object (LocaleObject)

Key/value pairs containing data stored by locale key.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

disableBulkEmailUserGroups
Array of integers

User groups that a manager will be prevented from sending bulk email to using the notify feature. Only the admin may edit this property.

disableSubmissions
boolean
Default: false
disableUserReg
boolean
disciplines
string

Enable disciplines metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

editorialTeam
object (LocaleObject)

Key/value pairs containing data stored by locale key.

emailSignature
string
enableAnnouncements
boolean
enableClockss
boolean
enabled
boolean
enableLockss
boolean
enableOai
boolean
Default: 1
enableOpenAccessNotification
boolean
enablePublisherId
Array of strings
enableSubscriptionOnlinePaymentNotificationPurchaseIndividual
boolean
enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional
boolean
enableSubscriptionOnlinePaymentNotificationRenewIndividual
boolean
enableSubscriptionOnlinePaymentNotificationRenewInstitutional
boolean
envelopeSender
string
object
object
itemsPerPage
integer
Default: 25
object
keywords
string
Default: "request"

Enable keywords metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

languages
string

Enable languages metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

librarianInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

licenseTerms
object (LocaleObject)

Key/value pairs containing data stored by locale key.

licenseUrl
string
lockssLicense
object (LocaleObject)

Key/value pairs containing data stored by locale key.

mailingAddress
string
membershipFee
number
Default: 0
membershipFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

membershipFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

name
object (LocaleObject)

Key/value pairs containing data stored by locale key.

numAnnouncementsHomepage
integer
numDaysBeforeInviteReminder
integer
numDaysBeforeSubmitReminder
integer
numMonthsAfterSubscriptionExpiryReminder
integer
numMonthsBeforeSubscriptionExpiryReminder
integer
numPageLinks
integer
Default: 10
numWeeksAfterSubscriptionExpiryReminder
integer
numWeeksBeforeSubscriptionExpiryReminder
integer
numWeeksPerResponse
integer
Default: 4
numWeeksPerReview
integer
Default: 4
onlineIssn
string
openAccessPolicy
object (LocaleObject)

Key/value pairs containing data stored by locale key.

pageFooter
object (LocaleObject)

Key/value pairs containing data stored by locale key.

object
paymentPluginName
string
paymentsEnabled
boolean
primaryLocale
string
printIssn
string
privacyStatement
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publicationFee
number
Default: 0
publicationFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publicationFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publisherInstitution
string
publishingMode
integer
purchaseArticleFee
number
Default: 0
purchaseArticleFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

purchaseArticleFeeEnabled
boolean
purchaseArticleFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

purchaseIssueFee
number
purchaseIssueFeeEnabled
boolean
rateReviewerOnQuality
boolean
readerInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

restrictArticleAccess
boolean
restrictOnlyPdf
boolean
restrictReviewerFileAccess
boolean
restrictSiteAccess
boolean
reviewerAccessKeysEnabled
boolean
reviewGuidelines
object (LocaleObject)

Key/value pairs containing data stored by locale key.

rights
string

Enable rights metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

searchDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

seq
integer
showEnsuringLink
boolean
sidebar
Array of strings
source
string

Enable source metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

object
subjects
string

Enable subjects metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

Array of objects
Default: [{"order":1,"content":{"defaultLocaleKey":"default.contextSettings.checklist.notPreviouslyPublished"}},{"order":2,"content":{"defaultLocaleKey":"default.contextSettings.checklist.fileFormat"}},{"order":3,"content":{"defaultLocaleKey":"default.contextSettings.checklist.addressesLinked"}},{"order":4,"content":{"defaultLocaleKey":"default.contextSettings.checklist.submissionAppearance"}},{"order":5,"content":{"defaultLocaleKey":"default.contextSettings.checklist.bibliographicRequirements"}}]
submissionFee
number
submissionFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

submissionFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subscriptionAdditionalInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subscriptionEmail
string
subscriptionExpiryPartial
boolean
subscriptionMailingAddress
string
subscriptionName
string
subscriptionPhone
string
supportedFormLocales
Array of strings
supportedLocales
Array of strings
supportedSubmissionLocales
Array of strings
supportEmail
string
supportName
string
supportPhone
string
themePluginPath
string
Default: "default"
timeFormat
object (LocaleObject)

Key/value pairs containing data stored by locale key.

type
string

Enable types metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

urlPath
string

Responses

Request samples

Content type
application/json
{
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "urlPath": "string"
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "id": 0,
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "url": "string",
  • "urlPath": "string"
}

Get a context.

path Parameters
contextId
required
integer

Context ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "id": 0,
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "url": "string",
  • "urlPath": "string"
}

Edit a context.

Edit a journal (OJS), press (OMP) or preprint server (OPS).

path Parameters
contextId
required
integer

Context ID

Request Body schema: application/json

The details about a context that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

abbreviation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

about
object (LocaleObject)

Key/value pairs containing data stored by locale key.

acronym
object (LocaleObject)

Key/value pairs containing data stored by locale key.

additionalHomeContent
object (LocaleObject)

Key/value pairs containing data stored by locale key.

agencies
string

Enable agencies metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

announcementsIntroduction
object (LocaleObject)

Key/value pairs containing data stored by locale key.

authorGuidelines
object (LocaleObject)

Key/value pairs containing data stored by locale key.

authorInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

citations
string

Enable citations metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

clockssLicense
object (LocaleObject)

Key/value pairs containing data stored by locale key.

competingInterests
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactAffiliation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactEmail
string
contactName
string
contactPhone
string
copyrightHolderOther
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightHolderType
string
copyrightNotice
object (LocaleObject)

Key/value pairs containing data stored by locale key.

copyrightYearBasis
string
Default: "issue"
coverage
string

Enable coverage metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

currency
string
customHeaders
object (LocaleObject)

Key/value pairs containing data stored by locale key.

dateFormatLong
object (LocaleObject)

Key/value pairs containing data stored by locale key.

dateFormatShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

datetimeFormatLong
object (LocaleObject)

Key/value pairs containing data stored by locale key.

datetimeFormatShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

defaultMetricType
string
defaultReviewMode
integer
Default: 2
delayedOpenAccessDuration
integer
delayedOpenAccessPolicy
object (LocaleObject)

Key/value pairs containing data stored by locale key.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

disableBulkEmailUserGroups
Array of integers

User groups that a manager will be prevented from sending bulk email to using the notify feature. Only the admin may edit this property.

disableSubmissions
boolean
Default: false
disableUserReg
boolean
disciplines
string

Enable disciplines metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

editorialTeam
object (LocaleObject)

Key/value pairs containing data stored by locale key.

emailSignature
string
enableAnnouncements
boolean
enableClockss
boolean
enabled
boolean
enableLockss
boolean
enableOai
boolean
Default: 1
enableOpenAccessNotification
boolean
enablePublisherId
Array of strings
enableSubscriptionOnlinePaymentNotificationPurchaseIndividual
boolean
enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional
boolean
enableSubscriptionOnlinePaymentNotificationRenewIndividual
boolean
enableSubscriptionOnlinePaymentNotificationRenewInstitutional
boolean
envelopeSender
string
object
object
itemsPerPage
integer
Default: 25
object
keywords
string
Default: "request"

Enable keywords metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

languages
string

Enable languages metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

librarianInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

licenseTerms
object (LocaleObject)

Key/value pairs containing data stored by locale key.

licenseUrl
string
lockssLicense
object (LocaleObject)

Key/value pairs containing data stored by locale key.

mailingAddress
string
membershipFee
number
Default: 0
membershipFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

membershipFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

name
object (LocaleObject)

Key/value pairs containing data stored by locale key.

numAnnouncementsHomepage
integer
numDaysBeforeInviteReminder
integer
numDaysBeforeSubmitReminder
integer
numMonthsAfterSubscriptionExpiryReminder
integer
numMonthsBeforeSubscriptionExpiryReminder
integer
numPageLinks
integer
Default: 10
numWeeksAfterSubscriptionExpiryReminder
integer
numWeeksBeforeSubscriptionExpiryReminder
integer
numWeeksPerResponse
integer
Default: 4
numWeeksPerReview
integer
Default: 4
onlineIssn
string
openAccessPolicy
object (LocaleObject)

Key/value pairs containing data stored by locale key.

pageFooter
object (LocaleObject)

Key/value pairs containing data stored by locale key.

object
paymentPluginName
string
paymentsEnabled
boolean
primaryLocale
string
printIssn
string
privacyStatement
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publicationFee
number
Default: 0
publicationFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publicationFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

publisherInstitution
string
publishingMode
integer
purchaseArticleFee
number
Default: 0
purchaseArticleFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

purchaseArticleFeeEnabled
boolean
purchaseArticleFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

purchaseIssueFee
number
purchaseIssueFeeEnabled
boolean
rateReviewerOnQuality
boolean
readerInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

restrictArticleAccess
boolean
restrictOnlyPdf
boolean
restrictReviewerFileAccess
boolean
restrictSiteAccess
boolean
reviewerAccessKeysEnabled
boolean
reviewGuidelines
object (LocaleObject)

Key/value pairs containing data stored by locale key.

rights
string

Enable rights metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

searchDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

seq
integer
showEnsuringLink
boolean
sidebar
Array of strings
source
string

Enable source metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

object
subjects
string

Enable subjects metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

Array of objects
Default: [{"order":1,"content":{"defaultLocaleKey":"default.contextSettings.checklist.notPreviouslyPublished"}},{"order":2,"content":{"defaultLocaleKey":"default.contextSettings.checklist.fileFormat"}},{"order":3,"content":{"defaultLocaleKey":"default.contextSettings.checklist.addressesLinked"}},{"order":4,"content":{"defaultLocaleKey":"default.contextSettings.checklist.submissionAppearance"}},{"order":5,"content":{"defaultLocaleKey":"default.contextSettings.checklist.bibliographicRequirements"}}]
submissionFee
number
submissionFeeDescription
object (LocaleObject)

Key/value pairs containing data stored by locale key.

submissionFeeName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subscriptionAdditionalInformation
object (LocaleObject)

Key/value pairs containing data stored by locale key.

subscriptionEmail
string
subscriptionExpiryPartial
boolean
subscriptionMailingAddress
string
subscriptionName
string
subscriptionPhone
string
supportedFormLocales
Array of strings
supportedLocales
Array of strings
supportedSubmissionLocales
Array of strings
supportEmail
string
supportName
string
supportPhone
string
themePluginPath
string
Default: "default"
timeFormat
object (LocaleObject)

Key/value pairs containing data stored by locale key.

type
string

Enable types metadata. 0 is disabled. enable will make it available in the workflow. request will allow an author to enter a value during submission. require will require that the author enter a value during submission.

urlPath
string

Responses

Request samples

Content type
application/json
{
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "urlPath": "string"
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "id": 0,
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "url": "string",
  • "urlPath": "string"
}

Delete a context.

Delete a journal (OJS), press (OMP) or preprint server (OPS).

path Parameters
contextId
required
integer

Context ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "abbreviation": {
    },
  • "about": {
    },
  • "acronym": {
    },
  • "additionalHomeContent": {
    },
  • "agencies": "string",
  • "announcementsIntroduction": {
    },
  • "authorGuidelines": {
    },
  • "authorInformation": {
    },
  • "citations": "string",
  • "clockssLicense": {
    },
  • "competingInterests": {
    },
  • "contactAffiliation": {
    },
  • "contactEmail": "string",
  • "contactName": "string",
  • "contactPhone": "string",
  • "copyrightHolderOther": {
    },
  • "copyrightHolderType": "string",
  • "copyrightNotice": {
    },
  • "copyrightYearBasis": "issue",
  • "coverage": "string",
  • "currency": "string",
  • "customHeaders": {
    },
  • "dateFormatLong": {
    },
  • "dateFormatShort": {
    },
  • "datetimeFormatLong": {
    },
  • "datetimeFormatShort": {
    },
  • "defaultMetricType": "string",
  • "defaultReviewMode": 2,
  • "delayedOpenAccessDuration": 0,
  • "delayedOpenAccessPolicy": {
    },
  • "description": {
    },
  • "disableBulkEmailUserGroups": [
    ],
  • "disableSubmissions": false,
  • "disableUserReg": true,
  • "disciplines": "string",
  • "editorialTeam": {
    },
  • "emailSignature": "string",
  • "enableAnnouncements": true,
  • "enableClockss": true,
  • "enableLockss": true,
  • "enableOai": 1,
  • "enableOpenAccessNotification": true,
  • "enablePublisherId": [
    ],
  • "enableSubscriptionOnlinePaymentNotificationPurchaseIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationPurchaseInstitutional": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewIndividual": true,
  • "enableSubscriptionOnlinePaymentNotificationRenewInstitutional": true,
  • "enabled": true,
  • "envelopeSender": "string",
  • "favicon": {
    },
  • "homepageImage": {
    },
  • "id": 0,
  • "itemsPerPage": 25,
  • "journalThumbnail": {
    },
  • "keywords": "request",
  • "languages": "string",
  • "librarianInformation": {
    },
  • "licenseTerms": {
    },
  • "licenseUrl": "string",
  • "lockssLicense": {
    },
  • "mailingAddress": "string",
  • "membershipFee": 0,
  • "membershipFeeDescription": {
    },
  • "membershipFeeName": {
    },
  • "name": {
    },
  • "numAnnouncementsHomepage": 0,
  • "numDaysBeforeInviteReminder": 0,
  • "numDaysBeforeSubmitReminder": 0,
  • "numMonthsAfterSubscriptionExpiryReminder": 0,
  • "numMonthsBeforeSubscriptionExpiryReminder": 0,
  • "numPageLinks": 10,
  • "numWeeksAfterSubscriptionExpiryReminder": 0,
  • "numWeeksBeforeSubscriptionExpiryReminder": 0,
  • "numWeeksPerResponse": 4,
  • "numWeeksPerReview": 4,
  • "onlineIssn": "string",
  • "openAccessPolicy": {
    },
  • "pageFooter": {
    },
  • "pageHeaderLogoImage": {
    },
  • "paymentPluginName": "string",
  • "paymentsEnabled": true,
  • "primaryLocale": "string",
  • "printIssn": "string",
  • "privacyStatement": {
    },
  • "publicationFee": 0,
  • "publicationFeeDescription": {
    },
  • "publicationFeeName": {
    },
  • "publisherInstitution": "string",
  • "publishingMode": 0,
  • "purchaseArticleFee": 0,
  • "purchaseArticleFeeDescription": {
    },
  • "purchaseArticleFeeEnabled": true,
  • "purchaseArticleFeeName": {
    },
  • "purchaseIssueFee": 0,
  • "purchaseIssueFeeEnabled": true,
  • "rateReviewerOnQuality": true,
  • "readerInformation": {
    },
  • "restrictArticleAccess": true,
  • "restrictOnlyPdf": true,
  • "restrictReviewerFileAccess": true,
  • "restrictSiteAccess": true,
  • "reviewGuidelines": {
    },
  • "reviewerAccessKeysEnabled": true,
  • "rights": "string",
  • "searchDescription": {
    },
  • "seq": 0,
  • "showEnsuringLink": true,
  • "sidebar": [
    ],
  • "source": "string",
  • "styleSheet": {
    },
  • "subjects": "string",
  • "submissionChecklist": [
    ],
  • "submissionFee": 0,
  • "submissionFeeDescription": {
    },
  • "submissionFeeName": {
    },
  • "subscriptionAdditionalInformation": {
    },
  • "subscriptionEmail": "string",
  • "subscriptionExpiryPartial": true,
  • "subscriptionMailingAddress": "string",
  • "subscriptionName": "string",
  • "subscriptionPhone": "string",
  • "supportEmail": "string",
  • "supportName": "string",
  • "supportPhone": "string",
  • "supportedFormLocales": [
    ],
  • "supportedLocales": [
    ],
  • "supportedSubmissionLocales": [
    ],
  • "themePluginPath": "default",
  • "timeFormat": {
    },
  • "type": "string",
  • "url": "string",
  • "urlPath": "string"
}

Get the active theme.

Get the active theme and theme options for any journal (OJS), press (OMP) or preprint server (OPS).

path Parameters
contextId
required
integer

Context ID

Responses

Response samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Edit the active theme.

Edit the active theme and theme options for any journal (OJS), press (OMP) or preprint server (OPS).

path Parameters
contextId
required
integer

Context ID

Request Body schema: application/json

The details you want to edit. The themePluginPath is required to specify the active theme, even if the theme is not being changed. Any additional keys/values must match the options defined by that theme.

...
string
themePluginPath
string

Responses

Request samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Response samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Site

Only admins can access these endpoints, which should be accessed using _ instead of the journal path.

Get the site.

Responses

Response samples

Content type
application/json
{
  • "about": {
    },
  • "contactEmail": {
    },
  • "contactName": {
    },
  • "enableBulkEmails": [
    ],
  • "installedLocales": [
    ],
  • "minPasswordLength": 0,
  • "pageFooter": {
    },
  • "pageHeaderTitleImage": {
    },
  • "primaryLocale": "string",
  • "privacyStatement": {
    },
  • "redirect": 0,
  • "sidebar": [
    ],
  • "styleSheet": {
    },
  • "supportedLocales": [
    ],
  • "themePluginPath": "default",
  • "title": {
    }
}

Edit the site.

Request Body schema: application/json

The details about the site that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

about
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactEmail
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contactName
object (LocaleObject)

Key/value pairs containing data stored by locale key.

enableBulkEmails
Array of integers

Which hosted journals, presses or preprint servers are allowed to send bulk emails.

installedLocales
Array of strings
minPasswordLength
integer
pageFooter
object (LocaleObject)

Key/value pairs containing data stored by locale key.

object
primaryLocale
string
privacyStatement
object (LocaleObject)

Key/value pairs containing data stored by locale key.

redirect
integer
sidebar
Array of strings
object
supportedLocales
Array of strings
themePluginPath
string
Default: "default"
title
object (LocaleObject)

Key/value pairs containing data stored by locale key.

Responses

Request samples

Content type
application/json
{
  • "about": {
    },
  • "contactEmail": {
    },
  • "contactName": {
    },
  • "enableBulkEmails": [
    ],
  • "installedLocales": [
    ],
  • "minPasswordLength": 0,
  • "pageFooter": {
    },
  • "pageHeaderTitleImage": {
    },
  • "primaryLocale": "string",
  • "privacyStatement": {
    },
  • "redirect": 0,
  • "sidebar": [
    ],
  • "styleSheet": {
    },
  • "supportedLocales": [
    ],
  • "themePluginPath": "default",
  • "title": {
    }
}

Response samples

Content type
application/json
{
  • "about": {
    },
  • "contactEmail": {
    },
  • "contactName": {
    },
  • "enableBulkEmails": [
    ],
  • "installedLocales": [
    ],
  • "minPasswordLength": 0,
  • "pageFooter": {
    },
  • "pageHeaderTitleImage": {
    },
  • "primaryLocale": "string",
  • "privacyStatement": {
    },
  • "redirect": 0,
  • "sidebar": [
    ],
  • "styleSheet": {
    },
  • "supportedLocales": [
    ],
  • "themePluginPath": "default",
  • "title": {
    }
}

Get the theme.

Get the active theme and theme options for the site.

Responses

Response samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Edit the theme.

Get the active theme and theme options for the site.

Request Body schema: application/json

The details you want to edit. The themePluginPath is required to specify the active theme, even if the theme is not being changed. Any additional keys/values must match the options defined by that theme.

...
string
themePluginPath
string

Responses

Request samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Response samples

Content type
application/json
{
  • "themePluginPath": "string",
  • "...": "string"
}

Announcements

Only admins and journal managers can access these endpoints.

Get a collection of announcements.

query Parameters
count
type
Default: 20

How many results to return in a single request.

offset
integer

Offset the results returned. Use this to receive subsequent pages of requests.

searchPhrase
string

Filter results by a search phrase matched against the title, descriptionShort, and description.

typeIds
Array of integers

Filter results by announcements of these announcement types.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Create a new announcement.

Create and publish a new announcement in this context.

Request Body schema: application/json

Details about the announcement that should be created.

assocId
integer

The journal, press or preprint server ID.

assocType
integer

The assoc object. This should always be ASSOC_TYPE_JOURNAL (OJS), ASSOC_TYPE_PRESS (OMP) or ASSOC_TYPE_SERVER (OPS).

dateExpire
string

(Optional) The date that this announcement expires, if one is set. This is typically used to express closing dates for calls for papers.

datePosted
string

The date this announcement was posted.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

descriptionShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

id
integer
title
object (LocaleObject)

Key/value pairs containing data stored by locale key.

typeId
integer

(Optional) One of the announcement type ids.

Responses

Request samples

Content type
application/json
{
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Get an announcement.

path Parameters
announcementId
required
integer

Announcement ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Edit an announcement.

Edit an announcement.

path Parameters
announcementId
required
integer

Announcement ID

Request Body schema: application/json

The details about the announcement that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

assocId
integer

The journal, press or preprint server ID.

assocType
integer

The assoc object. This should always be ASSOC_TYPE_JOURNAL (OJS), ASSOC_TYPE_PRESS (OMP) or ASSOC_TYPE_SERVER (OPS).

dateExpire
string

(Optional) The date that this announcement expires, if one is set. This is typically used to express closing dates for calls for papers.

datePosted
string

The date this announcement was posted.

description
object (LocaleObject)

Key/value pairs containing data stored by locale key.

descriptionShort
object (LocaleObject)

Key/value pairs containing data stored by locale key.

id
integer
title
object (LocaleObject)

Key/value pairs containing data stored by locale key.

typeId
integer

(Optional) One of the announcement type ids.

Responses

Request samples

Content type
application/json
{
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Delete an announcement.

Delete an announcement.

path Parameters
announcementId
required
integer

Announcement ID

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "assocId": 0,
  • "assocType": 0,
  • "dateExpire": "string",
  • "datePosted": "string",
  • "description": {
    },
  • "descriptionShort": {
    },
  • "id": 0,
  • "title": {
    },
  • "typeId": 0
}

Email Templates

Only admins and journal managers can access these endpoints.

Get email templates.

query Parameters
fromRoleIds
Array of integers

Filter results by email templates sent by one or more role IDs.

isCustom
string

Filter results by those with or without a default template. A truthy value will return only templates with a key that does not match one of the default templates. A falsey value will return only templates with a key that matches one of the default templates. Note that a default template may be customized, but this does not qualify for isCustom. Only completely custom templates, not a customization of a default template, will be returned when isCustom is true.

isEnabled
string

Filter results by enabled/disabled email templates. Any truthy or falsey value will get enabled/disabled email templates.

searchPhrase
string

Filter results by a search phrase matched against the key, subject, body, or description.

stageIds
Array of integers

Filter results by email templates that belong to one or more workflow stage IDs. Pass 0 to return templates not assigned to a stage.

toRoleIds
Array of integers

Filter results by email templates received by one or more role IDs.

Responses

Response samples

Content type
application/json
{
  • "itemsMax": 0,
  • "items": [
    ]
}

Create an email template.

Request Body schema: application/json

Details about the email template that should be created.

body
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contextId
integer

The ID of the context (journal/press) this email is related to. Only used for custom email templates. Default is null.

enabled
boolean

Is this email template enabled? Default is true.

key
string

A unique key for this email template.

subject
object (LocaleObject)

Key/value pairs containing data stored by locale key.

Responses

Request samples

Content type
application/json
{
  • "body": {
    },
  • "contextId": 0,
  • "enabled": true,
  • "key": "string",
  • "subject": {
    }
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "body": {
    },
  • "canDisable": true,
  • "canEdit": true,
  • "contextId": 0,
  • "description": {
    },
  • "enabled": true,
  • "fromRoleId": 0,
  • "id": 0,
  • "key": "string",
  • "stageId": 0,
  • "subject": {
    },
  • "toRoleId": 0
}

Get an email template by key.

Email templates are fetched by their key, rather than ID, so that a default template is retrieved if it has not been customized. See the documentation.

path Parameters
key
required
integer

Email template key

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "body": {
    },
  • "canDisable": true,
  • "canEdit": true,
  • "contextId": 0,
  • "description": {
    },
  • "enabled": true,
  • "fromRoleId": 0,
  • "id": 0,
  • "key": "string",
  • "stageId": 0,
  • "subject": {
    },
  • "toRoleId": 0
}

Edit an email template.

path Parameters
key
required
integer

Email template key

Request Body schema: application/json

The details about the email template that you want to edit. All params are optional. When a param is omitted, the existing value of that param will not be modified.

body
object (LocaleObject)

Key/value pairs containing data stored by locale key.

contextId
integer

The ID of the context (journal/press) this email is related to. Only used for custom email templates. Default is null.

enabled
boolean

Is this email template enabled? Default is true.

key
string

A unique key for this email template.

subject
object (LocaleObject)

Key/value pairs containing data stored by locale key.

Responses

Request samples

Content type
application/json
{
  • "body": {
    },
  • "contextId": 0,
  • "enabled": true,
  • "key": "string",
  • "subject": {
    }
}

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "body": {
    },
  • "canDisable": true,
  • "canEdit": true,
  • "contextId": 0,
  • "description": {
    },
  • "enabled": true,
  • "fromRoleId": 0,
  • "id": 0,
  • "key": "string",
  • "stageId": 0,
  • "subject": {
    },
  • "toRoleId": 0
}

Delete an email template.

Default templates that have not been modified can not be deleted.

path Parameters
key
required
integer

Email template key

Responses

Response samples

Content type
application/json
{
  • "_href": "http://example.com",
  • "body": {
    },
  • "canDisable": true,
  • "canEdit": true,
  • "contextId": 0,
  • "description": {
    },
  • "enabled": true,
  • "fromRoleId": 0,
  • "id": 0,
  • "key": "string",
  • "stageId": 0,
  • "subject": {
    },
  • "toRoleId": 0
}

Restore default email templates.

Delete custom templates and reset all templates to their default settings.

Responses

Response samples

Content type
application/json
[
  • "string"
]

Stats / Editorial

Only admins and journal managers can access these endpoints.

Get editorial activity stats.

Returns information about editorial activity such as the number of submissions accepted and declined, the number of days to reach editorial decisions, and the acceptance and rejection rates.

query Parameters
dateEnd
string

Return stats before this date.

dateStart
string

Return stats after this date.

sectionIds
Array of integers

Filter results by submissions to these sections.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Get yearly averages of editorial stats.

Returns yearly averages of editorial activity. To ensure averages are calculated fairly, partial years are not included in the averages. For example, if the first submission was received in October 2017 and the last submission was received in the current calendar year, only submissions from 2018 up until the end of the previous calendar year will be used to calculate the average.

query Parameters
sectionIds
Array of integers

Filter results by submissions to these sections.

Responses

Response samples

Content type
application/json
{
  • "submissionsReceived": 32,
  • "submissionsAccepted": 32,
  • "submissionsDeclined": 32,
  • "submissionsDeclinedDeskReject": 32,
  • "submissionsDeclinedPostReview": 32,
  • "submissionsPublished": 32
}

Stats / Publications

Only admins and journal managers can access these endpoints.

Get the views of a publication.

Returns a list of publications ordered by their total abstract views. Includes total views by abstract, all galleys, PDF galleys, HTML galleys and other galleys.

query Parameters
count
type
Default: 30

How many publications to return in a single request. Max is 100.

dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

offset
integer

Offset the publications returned. Use this to receive subsequent pages of requests.

orderDirection
integer
Default: "DESC"
Enum: "ASC" "DESC"

Return the results in ascending or descending order.

searchPhrase
string

Filter results by publications that match this search phrase. Searches the same submission properties as the searchPhrase parameter in the /submissions endpoint.

sectionIds
string

Filter results by publications in these sections.

submissionIds
Array of integers

Filter results by these submissions.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get abstract views by day or month.

Returns a monthly or daily timeline of abstract views for the publications which match the request parameters.

query Parameters
dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

searchPhrase
string

Filter results by publications that match this search phrase. Searches the same submission properties as the searchPhrase parameter in the /submissions endpoint.

sectionIds
Array of integers

Filter results by publications in these sections.

submissionIds
Array of integers

Filter results by these submissions.

timelineInterval
string
Default: "month"
Enum: "day" "month"

Return the total daily or monthly views

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get galley views by day or month.

Returns a monthly or daily timeline of galley views for the publications which match the request parameters.

query Parameters
dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

searchPhrase
string

Filter results by publications that match this search phrase. Searches the same submission properties as the searchPhrase parameter in the /submissions endpoint.

sectionIds
Array of integers

Filter results by publications in these sections.

submissionIds
Array of integers

Filter results by these publications.

timelineInterval
string
Default: "month"
Enum: "day" "month"

Return the total daily or monthly views.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get one publication's views by type.

Returns a publication's total views by abstract, all galleys, PDF galleys, HTML galleys and other galleys.

query Parameters
dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

Responses

Response samples

Content type
application/json
{
  • "abstractViews": 0,
  • "galleyViews": 0,
  • "pdfViews": 0,
  • "htmlViews": 0,
  • "otherViews": 0,
  • "publication": {
    }
}

Get onne publication's abstract views by day or month.

Returns a monthly or daily timeline of abstract views for the requested publication.

query Parameters
dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

timelineInterval
string
Default: "month"
Enum: "day" "month"

Return the total daily or monthly views

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get one publication's galley views by day or month.

Returns a monthly or daily timeline of galley views for the requested publication.

query Parameters
dateEnd
string

Return stats for publications before this date.

dateStart
string

Return stats for publications after this date.

timelineInterval
string
Default: "month"
Enum: "day" "month"

Return the total daily or monthly views.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Stats / Users

Only admins and journal managers can access these endpoints.

Get user statistics.

Returns a count of the number of user registrations broken down by roles.

Please note when using the registeredBefore and registeredAfter parameters that role counts reflect current user roles.

A user who registered as an author in January, 2019 but was later appointed to subeditor will be counted as a subeditor when the registration date range includes January, 2019.

query Parameters
registeredAfter
string

Return counts reflecting users who registered after this date.

registeredBefore
string

Return counts reflecting users who registered before this date.

status
string
Default: "active"
Enum: "active" "disabled"

Count active or disabled users. Default: active.

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Vocabs

Handle controlled vocabularies like keywords and subjects. Only admins, journal managers, subeditors, assistants and authors can access these endpoints.

Get controlled vocab entries.

query Parameters
locale
string

The locale key, such as en_US, you want to retrieve entries for. If no locale is provided, entries will be provided in the user's current locale or fall back to the journal's primary locale.

vocab
required
string

The type of controlled vocab you want to retrieve entries for. One of CONTROLLED_VOCAB_*.

Responses

Response samples

Content type
application/json
[
  • "string"
]

Temporary Files

A special endpoint to be used for handling file uploads. See the API Usage Guide for more information.

Get headers for file uploads.

Responds with the appopriate headers to indicate file uploads maybe be sent, required by some file upload utilities which send a preflight request.

Responses

Upload a file.

Upload a file to the temporary file storage area and receive a temporary file ID.

Request Body schema: application/json

Use any parameter key to upload your file. The API endpoint will retrieve the first uploaded file.

any

Responses

Request samples

Content type
application/json
null

Response samples

Content type
application/json
{
  • "id": 0
}

Backend

Private endpoints for OJS's UI. These endpoints will be less stable between versions. We discourage their use in third-party plugins or applications.

Save payment settings.

This endpoint is used on the settings page to save payment plugin settings alongside the general journal settings for enabling payments and setting the currency.

Request Body schema: application/json

None of these properties are required. In addition to paymentsEnabled and currency, you may pass any property that corresponds with a setting for an enabled paymethod plugin.

...
string
currency
string
paymentsEnabled
boolean

Responses

Request samples

Content type
application/json
{
  • "paymentsEnabled": true,
  • "currency": "string",
  • "...": "string"
}

Response samples

Content type
application/json
{
  • "name": [
    ],
  • "roles": [
    ]
}

Get headers for file uploads.

Responds with the appopriate headers to indicate file uploads maybe be sent, required by some file upload utilities which send a preflight request.

Responses

Upload a file.

The user's public file directory supports files uploaded through the TinyMCE rich text editor. This is commonly used in context settings but is also available to all registered users through their profile biography.

Request Body schema: application/json

Use the file key to upload your file.

any

Responses

Request samples

Content type
application/json
null

Response samples

Content type
application/json
{
  • "url": "string"
}

Get submissions.

This endpoint delivers a little bit of extra information about each submission that is used in the submissions list. This private endpoint saves a few extra HTTP requests, but it is more database-intensive for each query.

Responses