getPersonByDate

getPersonByDate API call retrieves a list of Person IDs based on a specified date range from ScholarOne Conferences system.

Method: GET

Required Parameters

  • Site Short Name
  • from_time
  • to_time

Optional Parameters

  • _type
  • External ID

Base URL

  • api.abstractcentral.com

Resource

  • /api/s1a/v3/abstracts/full/personids

Request Parameters

Request Element with Example or Default Value

getPersonByDate

TypeDescriptionReq
personidsRootYes

username

sample_user

String"Profile” Username.
This designation refers to the username used within the application system, distinct from a ScholarOne Conferences user. This information is sourced from the caller's profile.
Yes

Password

SRU4DQ5WOJ2PX8CA

StringThe API Key
Encrypted value uniquely identifying/authenticating Caller
Yes

site_name

acdemo

StringSite short name. The short name is the abbreviated or truncated name of the society, publisher, or family.Yes

from_time

'2024-04-01 00:00:00.000000'

dateTimeSpecifies the start of the date range in UTC. Only persons added or modified after this date will be included in the retrieval.
Formatted as (YYYY-MM-DD HH:MM:SS.SSSSSS)
Yes

to_time

'2024-10-20 23:59:59.999999'

dateTimeEnd of the date range in UTC. Only persons added or modified before this date will be included in the retrieval.
Formatted as (YYYY-MM-DD HH:MM:SS.SSSSSS)
Yes

url

v3/abstracts/full/personids

StringThe Web Service URL, which identifies the specific service to handle the request.Yes

external_id

123456

StringAn id value that can be set by the client for call tracking. API Caller supplied Text string to be stored with Audit History information.No

_type

Can be xml (default if omitted), or json

StringThe data type requested from the Service xml or JSON. This defaults to xmlNo

Response Elements

Response elements with Example or Default Value

getPersonByDate

TypeDescription

Status

Can be one of SUCCESS, FAILURE, or MAINTENANCE.
<status>SUCCESS</status>

StringState of a given request call

callID

<callId>63631fe1-7378-4cc1-ab18-87c06c2eff58</callId>

StringThe CALL_ID is the unique identifier for a given Web Services call. Generated by the ScholarOne Web Services application.

profileCallId

<profileCallId>111111</profileCallId>

StringAn id value that is set by the client for call tracking. Set by the request’s external_id element.

personIdList

Complex Child of Parent Root
Includes the following response elements:

personId

ComplexContainer element that holds a collection of personid elements. It represents a list of unique person identifiers that match the specified query parameters (such as date range, site name, and type).

personId

<personId>6042605</personId>

IntegerUnique identifier for each person in the ScholarOne Conferences system. Internally to ScholarOne, this is a numeric value.