getAuthorInfoFull
getAuthorInfoFull sends a request with either a Document ID or IDs, or a Submission ID or IDs, and retrieves detailed metadata about the author or authors of a particular manuscript or group of manuscripts.
Required Parameters
- Submission ID(s) or Document ID(s) - up to 25
- Site Short Name
Optional Parameters
- Locale ID
- _type
- External ID
Resource
- By documentID:
/api/s1m/v3/submissions/full/contributors/authors/documentids - By submissionID:
/api/s1m/v3/submissions/full/contributors/authors/submissionids
Request Parameters
| Element | Type | Description | Required | Example or Default Value |
|---|---|---|---|---|
| getAuthorInfoFull | Root | Yes | ||
| username | String | Profile User Name. This is the user name used by the API, not a ScholarOne Manuscripts user. This is from the Caller’s profile. | Yes | sample_user |
| password | String | The API Key. Encrypted value uniquely identifying and authenticating Caller | Yes | SRU4DQ5WOJ2PX8CA |
| ids† | Integer or Integer Array | Document Id or Ids. Unique identifier for each Manuscript Revision in the ScholarOne Manuscripts system. Internally to ScholarOne, this is a numeric value. Each entry must be surrounded by single or double quotes and comma separated when more than one entry is specified. | Yes, if submission IDs are not used. | ’88026’ Or if a list is being requested: '88026','88087','89328' |
| ids†† | String or String Array | Submission Id or Ids. Also known as the Manuscript ID or Document Number. Identifier that is seen in the ScholarOne UI for each Manuscript. Submission Ids are case-sensitive. Each entry must be surrounded by single or double quotes and comma separated when more than one entry is specified. | Yes, if document IDs are not used. | 'WEB-2013-0002' Or if a list is being requested: 'WEB-2013-0002','WEB-2013-0003' |
| site_name | String | Site short name. The short name is the abbreviated or truncated name of the journal, society, publisher, or family. | Yes | web_svcs |
| url | String | The Web Service URL, which identifies the specific service to handle the request. | Yes | v3/submissions/full/contributors/authors/documentids |
| external_id | String | An id value that can be set by the client for call tracking. Caller supplied Text string to be stored with Audit History information. | No | 123456 |
| locale_id | Integer | The unique identifier for a specific language. The value of the locale_id must match to the specific language as defined in the Caller’s profile. | No | Options are:
|
| _type | String | The data type requested from the Service <xml> or <json>. This defaults to <xml>. | No | xml (default if omitted), or json |
Response Elements
Response Element | Type | Description | Example or default Value |
|---|---|---|---|
Status | String | State of a given request call | Can be one of SUCCESS, FAILURE, or MAINTENANCE.
|
callID | String | The CALL_ID is the unique identifier for a given Web Services call. Generated by the ScholarOne Web Services application. |
|
profileCallId | String | An id value that is set by the client for call tracking. Set by the request’s external_id element. |
|
authorFirstName | String | The first or given name of the author. |
|
authorFullAddress | String | Concatenated address fields of the author in the format “address1; address2; address3; city, stateOrProvidence; postalCode; country” |
|
authorFullName | String | The full name of the author in the format “Lastname Suffix, Salutation Firstname Middlename”. Submitting Author or Submitting Agent. |
|
authorLastName | String | The last name (surname or family name) of the author. |
|
authorMembershipId | String | Society Membership number of the user. |
|
authorMiddleName | String | The middle name of the author. |
|
authorORCIDId | String | The ORCID is a nonproprietary alphanumeric code to uniquely identify scientific and other academic authors. |
|
authorORCIDIdValidation | Boolean | Indication of whether that author ORCID has been validated by the author. |
|
authorOrderNumber | Integer | Order in which the author is listed on the document. Order number of the author as entered in the Author & Institutions page during submission. |
|
authorPersonId | Integer | A unique numeric identifier associated with a person record (not the user's User ID used for accessing ScholarOne). |
|
authorPrimaryEmailAddress | String | The primary e-mail address of the author. | |
authorResearcherId | String | Provides solution to Author ambiguity by assigning a unique identifier for scientific authors. |
|
authorSalutation | String | The salutation chosen for an author in their account record, often Dr., Miss, or Mr. |
|
authorSuffix | String | The suffix chosen in the author’s account record. |
|
documentId | Integer | Unique identifier of the document. Unique identifier for each Manuscript Revision in the ScholarOneManuscripts system. Internally to ScholarOne, this is a numeric value. |
|
inputIndex | Integer | Provides caller the ability to correlate requested document or submission ids to the appropriate response element. The inputIndex will be randomly chosen when a document or submission id is entered more than once. | |
invitedAuthorDateAssigned | dateTime | The date an invited author was assigned to submit the manuscript (the date the author was assigned to the given stub). | |
invitedAuthorDateInvited | dateTime | The date an invited author was invited to submit the given manuscript. | |
invitedAuthorDateResponse | dateTime | The date an invited author responded to the invitation to submit a manuscript. | |
invitedAuthorDateSelected | dateTime | The date an invited author was selected to submit the given manuscript. | |
invitedAuthorInvitationResponse | String | The answer an invited author gave in response to the invitation to submit the given manuscript. | |
invitedAuthorInvitationResponseId | Integer | Unique ID of the invitation response in the ScholarOne Manuscripts database. | |
isCoAuthor | Boolean | Indication of whether that author is of type Co-Author on the given manuscript. “true” indicates that author is a co-author for that submission. |
|
isContact | Boolean | Indication of whether that author is of type Contact Author on the given manuscript (as opposed to Submitting Author, for example). The contact author will be contacted during the peer review process and used for email tags. |
|
isCorresponding | Boolean | Indication of whether that author is of type Corresponding Author on the given manuscript (as opposed to Submitting Author, for example). |
|
isInvited | Boolean | Indication of whether that author is the invited author on the given manuscript. |
|
isSubmittingAgent | Boolean | Indication if the individual submitting the manuscript is one of the co-authors representing themselves and their collaborators, or if they are an external submitting agent not listed as an author. |
|
isSubmittingAuthor | Boolean | Indication of whether that author is of type Submitting Author on the given manuscript(as opposed to a Co-Author, for example). |
|
submissionId | String | Also known as the Manuscript Id or Document Number. A unique identifier given to each submitted manuscript. Submission IDs are case-sensitive, they are not necessarily unique. |
|
departments | Complex | The connection between the author and their departmental affiliation(s). It retains address information from the time of submission rather than updating it to the current details for the person. | Complex Child of Parent Root |
address1 | String | Author's department address line 1 from the author >> department record. |
|
address2 | String | Author's department address line 2 from the author >> department record. |
|
address3 | String | Author's department address line 3 from the author >> department record. |
|
affiliationOrderNumber | Integer | The order contributing authors entered their affiliations into the ScholarOne Manuscripts system. An affiliation at the time research was completed. | |
city | String | Author's department city name from the author>>department record. |
|
country | String | Author's department country name from the author>>department record. |
|
countryCode | String | Author's department standard country code; foreign key to the Country table. |
|
department | String | Author's affiliated department name from the author>>department record. |
|
fax | String | Author's department fax number from the author>>department record. |
|
institution | String | Institution name of the author from the author>>department record. |
|
phone1 | String | Author's department primary phone number from the author>>department record. |
|
phone2 | String | Author's department alternate phone number from the author>>department record. |
|
postalCode | String | Author's department zip code from the author>>department record. |
|
ringgoldId | String | Author's institution Ringgold ID identifier. |
|
roomOrSuite | String | Author's department state or providence name from the author>>department record. |
|
stateOrProvince | String | Author's department state or providence name from the author>>department record. |
|
title | String | Author's department title from the author>>department record. |
|
Updated 5 months ago
