openapi: 3.0.1
servers:
- url: https://api.adp.com
description: 'ADP production API gateway (mutual-TLS). Source: https://developers.adp.com/getting-started/key-concepts/access-tokens'
- url: https://api.eu.adp.com
description: ADP European API gateway
- url: https://uat-api.adp.com
description: ADP UAT / sandbox gateway
info:
contact:
name: Vamshi Krishna Guduru
email: VAMSHI.KRISHNA.GUDURU@ADP.COM
description: This API includes the ability to request, review, approve, or reject a time off request by an employee or a
manager. For more information please refer Time Off Request API Guide for ADP Workforce Now guide.
title: Time Off Requests
version: 3.0.9
x-apievangelist-source: https://api-library-marketplace.adp.com/hcm-offrg-wfn/time/time-off-requests/v3/time-off-requests-swagger_v3-merged.json
x-apievangelist-product: ADP Workforce Now (hcm-offrg-wfn)
x-apievangelist-resource-path: time/time-off-requests/v3/time-off-requests
x-adpSpecData:
domain: Time
specId: ae1599e1-4b02-4925-97dd-3c6c1018b489
canonicalSpecId: 7ac5618b-37d6-4b8a-9815-c53964dc0da0
specStatusCode: publishing
specTypeCode: REST
specStateCode: active
nonStandardIndicator: false
visibilityCodes:
- internal
- external
filename: time-off-requests-swagger_v3-merged.json
serviceProviderId: 'null'
resourcePath: time/time-off-requests/v3
libraryVersion: ''
businessRules:
- rule: R8.3
ruleTitle: 'A self link is included in the /data/links with 1 links item with the following 2 properties: rel=”self” href=”/events-notifications/{domain}/v1/{event-name}/{eventID}”'
visibilityCodes:
- internal
- rule: R3.0
ruleTitle: /data/schemaContext communicates the keys and properties that relate the event instance to a concrete concept
(e.g. associate).
visibilityCodes:
- internal
- rule: R3.4
ruleTitle: /data/output may be provided during the recording of the event showing the intermediary results.
visibilityCodes:
- internal
- rule: R3.3
ruleTitle: /data/output communicates the result of the event instance.
visibilityCodes:
- internal
- rule: R1.0
ruleTitle: event.id is generated once an event is recorded with a event.status.code=complete
visibilityCodes:
- internal
- rule: R11.1
ruleTitle: '''associateoid'' in the uri pattern should match the ''associateoid'' in the request header parameter'
visibilityCodes:
- internal
- rule: R4.2
ruleTitle: The actions/enabledIndicator set to true indicates that the control should be shown to the user with the actions/title
and it is actionable. True is the default.
visibilityCodes:
- internal
- rule: R0.1
ruleTitle: If request contains ADP-Act-As-OrgOID, ADP-Act-As-AssociateOID and ADP-Acting-SessionID header values, SOR
MUST use ADP-Act-As-AssociateOID header value to authorize the data requested, NOT associateoid header value to authorize
the data.
visibilityCodes:
- internal
- rule: R0.3
ruleTitle: 'For Act-As or On-Behalf-Of requests, header ''Cache-Control: no-store'' MUST be set to indicate on server
or on UI the response object SHOULD not be cached'
visibilityCodes:
- internal
- rule: R4.5
ruleTitle: actions/links/rel=/adp/invoke, href={uri}, method={verb} describes the method and uri to invoke this action.
visibilityCodes:
- internal
- rule: R5.0
ruleTitle: Meta returns the context rules for each data section
visibilityCodes:
- internal
- rule: R2.3
ruleTitle: effectiveDateTime is the date that the event is effective from a business perspective
visibilityCodes:
- internal
- rule: R6.2
ruleTitle: An event instance which has been recorded has an event.status.code=complete
visibilityCodes:
- internal
- rule: R15.1
ruleTitle: 'An SOR may return an HTTP 503 when they are down for a scheduled maintenance or for an outage.If an SOR is
planning a maintenance window then they should plan on having an end point available to return the 503 with a standard
confirmMessage. The confirmMessage will contain a message stating the date and timeframe that the maintenance window
is for.The SOR should return the Retry-After response-header field with the Date and Time when they expect the system
to be available. E.g. § Retry-After: Fri, 31 Dec 1999 23:59:59 GMT This does not need to be handled dynamically. They
can set the time that their maintenance window ends.'
visibilityCodes:
- internal
- rule: R5.1
ruleTitle: The only information that must be valued in the meta for the events header are the standard codelist references
for priorityCode, eventStatusCode, and serviceCategoryCode
visibilityCodes:
- internal
- rule: R4.0
ruleTitle: All envelope data is set by the System of Record (e.g. event.ID, creationDateTime, recordDateTime, event.status.code,
etc…
visibilityCodes:
- internal
- rule: R0.2
ruleTitle: If request contains ADP-On-Behalf-Of-OrgOID, ADP-On-Behalf-Of-AssociateOID and ADP-Acting-SessionID header
values, SOR MUST use ADP-On-Behalf-Of-AssociateOID header value to authorize the data requested, NOT associateoid header
value to authorize the data.
visibilityCodes:
- internal
- rule: R3.6
ruleTitle: An event which is being recorded includes the /data/eventContext and the /data/transform during the composition
phase (i.e. recording of the event).
visibilityCodes:
- internal
- rule: R2.4
ruleTitle: If there is no effective date from a business perspective then the effective date should be set equal to the
record date time.
visibilityCodes:
- internal
- rule: R3.5
ruleTitle: A complete event has /data/eventContext and /data/output
visibilityCodes:
- internal
- rule: R4.4
ruleTitle: actions/links describes how to invoke the action.
visibilityCodes:
- internal
- rule: R6.1
ruleTitle: An event instance which is being “worked on” has an event.status.code=inprogress
visibilityCodes:
- internal
- rule: R2.2
ruleTitle: The recordDateTime is the date time which the event is recorded in the system of record with an event.status.code=complete
visibilityCodes:
- internal
- rule: R4.3
ruleTitle: The actions/enabledIndicator set to false indicates that the control should be shown to the user with the actions/title
but it is not actionable.
visibilityCodes:
- internal
- rule: R8.1
ruleTitle: An event notification includes the /data/eventContext and /data/output objects.
visibilityCodes:
- internal
- rule: R2.1
ruleTitle: If the event is declared by an actor then the creationDateTime is the date time when the first call is made
to the System of Record.
visibilityCodes:
- internal
- rule: R2.0
ruleTitle: creationDateTime is the date that the event is created. If a System of Record creates the event instance then
it sets the creationDateTime.
visibilityCodes:
- internal
- rule: R3.1
ruleTitle: /data/input is optional. Input communicates data that is needed to complete recording the event instance. An
example is a benefits.enroll event. The input communicates the benefitOfferings (the choices) that the user has to
make which are communicated in the transform.
visibilityCodes:
- internal
- rule: R6.0
ruleTitle: An event instance may be created by a System of record for a user to complete. This event instance will have
a event.status.code=created
visibilityCodes:
- internal
- rule: R4.6
ruleTitle: actions/links/rel=describedby, href={meta uri}, method=GET describes the call to get the meta that returns
the relevancy and validation rules for the action.
visibilityCodes:
- internal
- rule: R4.1
ruleTitle: The actions/title is the user visible title to be given to the control of the action.
visibilityCodes:
- internal
- rule: R3.2
ruleTitle: /data/transform is only used during the recording of the event. The transform is the data that is provided
by a user/machine to complete the recording of the event.
visibilityCodes:
- internal
- rule: R8.2
ruleTitle: An event notification does not include the transform or meta objects.
visibilityCodes:
- internal
eventNotifications:
- eventCode: timeOffRequest.review.eventNotify.subscribe
example:
href: event-notification-Approved-status.json
testCaseCollection:
example:
href: Time Off Requests_WFN.postman_collection.json
description: Time Off Requests Postman Collection
publicationContext:
products:
- productId: hcm-offrg-wfn
productName: workforce now
marketplaceProductName: ADP Workforce Now®
specCategoryCode: ''
tags:
- name: Worker Time Off Requests
description: List a worker's time off requests
paths:
/time/v3/workers/{aoid}/time-off-request-summaries:
x-adpPathData:
uriTranslationIndicator: false
featureCode: timeOffManagement
functionCode: timeOffRequestManagement
serviceCode: timeLaborManagement
serviceCategoryCode: time
canonicalName: Time Off Request Summaries
get:
summary: Worker Time Off Request Summaries
x-adpOperationData:
asaFeatureCodes:
- MobileMSSPTO
- MobilePSSPTO
- MobileESSPTO
canonicalUri: time/timeLaborManagement/timeOffManagement/timeOffRequestManagement/timeOffRequestSummary.read
operationCode: timeOffRequestSummary.read
roleCodes:
- manager
- practitioner
- employee
scenarios:
- summary: New description scenario for the consumer of this API to better understand this example.
name: 1. Time off request summaries
responses:
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01&$skip=1&$top=20&$orderby= DeniedRequestQuantity asc
Successful response when time of request summaries are requested with OrderBy DeniedRequestQuantity filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352932.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01 and requestorName eq Anthony &$skip=1&$top=20
Successful response when time of request summaries are requested with OData Top and Skip filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352923.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: Successful response when time of request summaries are requested with a start and end date time filter.
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352924.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01&$skip=1&$top=20&$orderby=positionId asc
Successful response when time of request summaries is requested with OrderBy positionID filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352928.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: 'time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2019-01-01 and requestEndDate
eq 2020-01-01&$skip=1&$top=20&$orderby=requestorName asc
Successful response when time of request summaries are requested with OrderBy requestorName filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352926.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01 and requestorName eq Anthony
Successful response when time of request summaries are requested with a requestorName filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352925.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01&$skip=1&$top=20&$orderby= approvedRequestQuantity asc
Successful response when time of request summaries are requested with OrderBy ApprovedRequestQuantity filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352931.json
- headers:
ADP-Acting-Session-Expires: ''
Cache-Control: ''
sm_transactionid: ''
ETag: ''
ADP-Acting-SessionID: ''
Content-Type: ''
code: '200'
description: '/time/v3/workers/{AOID}/time-off-request-summaries?$filter=requestStartdate eq 2000-01-01 and requestEndDate
eq 2010-01-01&$skip=1&$top=20&$orderby= pendingRequestQuantity asc
Successful response when time of request summaries are requested with OrderBy pedingRequestQuantity filter.'
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_200_352929.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the Invalid OrderBy value is passed.
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_400_352935.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the start and end date field is not passed.
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_400_352933.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the Invalid resquestorName is passed.
content:
application/json:
externalValue: ./examples/1._Time_off_request_summaries_Custom_Example_timeOffRequestSummary.read_400_352934.json
description: New description scenario for the consumer of this API to better understand this example.
globalViewDevPortalIndicator: true
operationStateCode: active
grantTypes:
- authorization_code
- urn:ietf:params:oauth:grant-type:saml2-bearer
- urn:ietf:params:oauth:grant-type:jwt-bearer
- client_credential
sorRequestTimeoutPolicies:
cachedTimeout: 3
notCachedTimeout: 10
operationId: f0c00538-c249-4904-9717-aa3894361d26
performAuthIndicator: true
dataSensitivityLevelCode: 2
visibilityCodes:
- internal
- external
responses:
'200':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Content-Type:
schema:
type: string
description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Request summaries of all available worker time off requests that the requester is authorized to view
content:
application/json:
schema:
$ref: ./schemas/timeOffRequestSummaries_schema_v03_00_rev001.json
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'412':
$ref: '#/components/responses/412'
'500':
$ref: '#/components/responses/500'
'204':
$ref: '#/components/responses/204'
'413':
$ref: '#/components/responses/413'
'403':
$ref: '#/components/responses/403'
'304':
$ref: '#/components/responses/304'
'404':
$ref: '#/components/responses/404'
'503':
$ref: '#/components/responses/503'
'504':
$ref: '#/components/responses/504'
'405':
$ref: '#/components/responses/405'
'406':
$ref: '#/components/responses/406'
'429':
$ref: '#/components/responses/429'
operationId: f0c00538-c249-4904-9717-aa3894361d26
description: Request summaries of all available worker time off requests that the requester is authorized to view
parameters:
- schema:
default: ''
type: string
in: header
name: sm_userdn
description: 'SiteMinder user LDAP distinguished name. Required for requests where conversation was initiated from
a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_userdn: uid=JJohns@Abc,ou=Users,o=Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ConsumerAppOID
description: Identifier for the service consumer application. This header is required, if the actor (Service Consumer)
is an application or the actor is internal to ADP
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: boolean
in: query
name: $count
description: "Use the OData $count parameter to specify that the response should return the total number of instance\
\ resources \n\nEx. $count=true"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-OrgOID
description: Org OID for organization of the associate that is the actor in ' On Behalf Of' as provisioned by the
ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: header
name: associateoid
description: Associate OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: Authorization
description: Provides the client's authorization token to access the resource representation at a URI
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_transactionid
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: number
in: query
name: $top
description: "Use the OData $top parameter to specify the maximum number of entries that should be returned in the\
\ response, starting from the beginning. \n\nEx. $top=10"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ISI
type: string
in: header
name: realm
description: The identity management realm, e.g. ISI
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: query
name: $orderby
description: "Use the OData $orderby parameter to specify that the response be sorted by the specified field in either\
\ ascending or descending order. \n\nEx. $orderby=requestDateTime desc"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Acting-SessionID
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-AssociateOID
description: Associate OID of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_auth_level
description: 'SiteMinder autorization level. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_auth_level: 10'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORContext
description: Context within an SOR that the call should be routed to
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Consumer-ApplicationID
description: Identifier of the application sending a request - not intended to be used as a correlation id for messages
across systems participating in a collaboration
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: orgoid
description: Organization OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-AssociateOID
description: Associate OID for the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_serversessionid
description: 'SiteMinder session ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_serversessionid: SoFpy8UMyhtXY6YsEumvXJbznFA='
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: path
name: aoid
description: Associate OID
x-adpParameterData:
visibilityCodes:
- internal
- external
required: true
- schema:
default: ''
type: string
in: query
name: $filter
description: 'The OData $filter parameter MUST be used to specify the filter criterion. Please refer "RESTful Web
API Design Standard" for more details. Example: /core/v1/associates/{aoid}/documents?$filter=(documents/modifiers/modifierAOID
eq ‘G2O73G9Z62SL2NF2’ or documents/fileTypeCode/codeValue eq ‘xls’) and documents/categoryCode/codeValue eq ‘1006003’'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: number
in: query
name: $skip
description: "Use the OData $skip parameter to specify the number of entries from response data to ignore. \n\nEx.\
\ $skip=10"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORUri
description: Actual Uri within the SOR
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_user
description: 'SiteMinder user ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_user: JJohns@Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Context-ExpressionID
description: Geopolitical context, typically country, region, e.g. country=CA;subdivision=Quebec
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SOR
description: SOR where the call is routed to - usuall injected by the API proxy, with few exceptions
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-OrgOID
description: Org OID for organization of the associate that is the actor in 'Acting As' as provisioned by the ADP
Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: employee
type: string
enum:
- employee
- ' manager'
- ' practitioner'
- ' administrator'
- ' supervisor'
in: header
name: roleCode
description: 'The role the user is playing during the transaction. Possible values: employee,manager,practitioner,administrator,supervisor. The
roleCode header should be passed in all calls.'
x-adpParameterData:
visibilityCodes:
- internal
required: true
tags:
- Worker Time Off Requests
/time/v3/workers/{aoid}/team-time-off-request-summaries:
x-adpPathData:
uriTranslationIndicator: false
featureCode: timeOffManagement
functionCode: timeOffRequestManagement
serviceCode: timeLaborManagement
serviceCategoryCode: time
canonicalName: Team Time Off Request Summaries
get:
summary: Team Time Off Request Summaries
x-adpOperationData:
asaFeatureCodes:
- MobilePSSPTO
- MobileMSSPTO
canonicalUri: time/timeLaborManagement/timeOffManagement/timeOffRequestManagement/teamTimeOffRequestSummary.read
operationCode: teamTimeOffRequestSummary.read
roleCodes:
- practitioner
- manager
scenarios:
- summary: New description scenario for the consumer of this API to better understand this example.
name: 1. Team time off request summaries
responses:
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries is requested with OrderBy positionID filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352940.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with OrderBy ApprovedRequestQuantity
filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352942.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with OData Top and Skip filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352937.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with OrderBy DeniedRequestQuantity
filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352943.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with a start and end date time filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352936.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with OrderBy requestorName filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352939.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with OrderBy pedingRequestQuantity
filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352941.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '200'
description: Successful response when time of request summaries are requested with a requestorName filter.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_200_352938.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the Invalid OrderBy value is passed.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_400_352946.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the start and end date field is not passed.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_400_352944.json
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
Content-Type: unset
code: '400'
description: Unsuccessful response when the Invalid resquestorName is passed.
content:
application/json:
externalValue: ./examples/1._Team_time_off_request_summaries_Custom_Example_teamTimeOffRequestSummary.read_400_352945.json
description: New description scenario for the consumer of this API to better understand this example.
globalViewDevPortalIndicator: true
operationStateCode: active
grantTypes:
- authorization_code
- urn:ietf:params:oauth:grant-type:saml2-bearer
- urn:ietf:params:oauth:grant-type:jwt-bearer
- client_credential
sorRequestTimeoutPolicies:
cachedTimeout: 3
notCachedTimeout: 10
operationId: 3a1428bd-7471-460f-ac47-5eb7e15e3879
performAuthIndicator: true
dataSensitivityLevelCode: 2
visibilityCodes:
- internal
- external
responses:
'200':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Content-Type:
schema:
type: string
description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Request summaries of all time off requests for the team that the requester is authorized to view
content:
application/json:
schema:
$ref: ./schemas/timeOffRequestSummaries_schema_v03_00_rev001.json
'400':
$ref: '#/components/responses/400'
'500':
$ref: '#/components/responses/500'
'401':
$ref: '#/components/responses/401'
'412':
$ref: '#/components/responses/412'
'413':
$ref: '#/components/responses/413'
'304':
$ref: '#/components/responses/304'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'503':
$ref: '#/components/responses/503'
'405':
$ref: '#/components/responses/405'
'504':
$ref: '#/components/responses/504'
'406':
$ref: '#/components/responses/406'
'429':
$ref: '#/components/responses/429'
operationId: 3a1428bd-7471-460f-ac47-5eb7e15e3879
description: Request summaries of all available time off requests for the team that the requester is authorized to view
parameters:
- schema:
default: ''
type: string
in: header
name: sm_userdn
description: 'SiteMinder user LDAP distinguished name. Required for requests where conversation was initiated from
a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_userdn: uid=JJohns@Abc,ou=Users,o=Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ConsumerAppOID
description: Identifier for the service consumer application. This header is required, if the actor (Service Consumer)
is an application or the actor is internal to ADP
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: boolean
in: query
name: $count
description: "Use the OData $count parameter to specify that the response should return the total number of instance\
\ resources \n\nEx. $count=true"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-OrgOID
description: Org OID for organization of the associate that is the actor in ' On Behalf Of' as provisioned by the
ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: header
name: associateoid
description: Associate OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: Authorization
description: Provides the client's authorization token to access the resource representation at a URI
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_transactionid
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: number
in: query
name: $top
description: "Use the OData $top parameter to specify the maximum number of entries that should be returned in the\
\ response, starting from the beginning. \n\nEx. $top=10"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ISI
type: string
in: header
name: realm
description: The identity management realm, e.g. ISI
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: query
name: $orderby
description: "Use the OData $orderby parameter to specify that the response be sorted by the specified field in either\
\ ascending or descending order. \n\nEx. $orderby=requestDateTime desc"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Acting-SessionID
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-AssociateOID
description: Associate OID of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_auth_level
description: 'SiteMinder autorization level. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_auth_level: 10'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORContext
description: Context within an SOR that the call should be routed to
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: orgoid
description: Organization OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-AssociateOID
description: Associate OID for the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_serversessionid
description: 'SiteMinder session ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_serversessionid: SoFpy8UMyhtXY6YsEumvXJbznFA='
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Consumer-ApplicationID
description: Identifier of the application sending a request - not intended to be used as a correlation id for messages
across systems participating in a collaboration
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: path
name: aoid
description: Associate OID
x-adpParameterData:
visibilityCodes:
- internal
- external
required: true
- schema:
default: ''
type: string
in: query
name: $filter
description: 'The OData $filter parameter MUST be used to specify the filter criterion. Please refer "RESTful Web
API Design Standard" for more details. Example: /core/v1/associates/{aoid}/documents?$filter=(documents/modifiers/modifierAOID
eq ‘G2O73G9Z62SL2NF2’ or documents/fileTypeCode/codeValue eq ‘xls’) and documents/categoryCode/codeValue eq ‘1006003’'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: number
in: query
name: $skip
description: "Use the OData $skip parameter to specify the number of entries from response data to ignore. \n\nEx.\
\ $skip=10"
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORUri
description: Actual Uri within the SOR
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_user
description: 'SiteMinder user ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_user: JJohns@Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Context-ExpressionID
description: Geopolitical context, typically country, region, e.g. country=CA;subdivision=Quebec
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SOR
description: SOR where the call is routed to - usuall injected by the API proxy, with few exceptions
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-OrgOID
description: Org OID for organization of the associate that is the actor in 'Acting As' as provisioned by the ADP
Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: employee
type: string
enum:
- employee
- ' manager'
- ' practitioner'
- ' administrator'
- ' supervisor'
in: header
name: roleCode
description: 'The role the user is playing during the transaction. Possible values: employee,manager,practitioner,administrator,supervisor. The
roleCode header should be passed in all calls.'
x-adpParameterData:
visibilityCodes:
- internal
required: true
tags:
- Worker Time Off Requests
/time/v3/workers/{aoid}/time-off-request-summaries/meta:
x-adpPathData:
uriTranslationIndicator: false
featureCode: timeOffManagement
functionCode: timeOffRequestManagement
serviceCode: timeLaborManagement
serviceCategoryCode: time
canonicalName: Time Off Request Summaries
get:
summary: Worker Time Off Request Summary Meta
x-adpOperationData:
operationStateCode: active
grantTypes:
- authorization_code
- urn:ietf:params:oauth:grant-type:saml2-bearer
- urn:ietf:params:oauth:grant-type:jwt-bearer
- client_credential
asaFeatureCodes:
- MobilePSSPTO
- MobileESSPTO
- MobileMSSPTO
canonicalUri: time/timeLaborManagement/timeOffManagement/timeOffRequestManagement/timeOffRequestSummary.read
sorRequestTimeoutPolicies:
cachedTimeout: 3
notCachedTimeout: 10
operationCode: timeOffRequestSummary.read
operationId: 04b981a3-253d-48d3-b647-abdaa5a9bf1f
roleCodes:
- practitioner
- employee
- manager
performAuthIndicator: true
scenarios:
- summary: Time off request summaries - Meta
name: Time off request summaries - Meta
responses:
- headers:
ADP-Acting-Session-Expires: unset
Cache-Control: unset
sm_transactionid: unset
ETag: unset
ADP-Acting-SessionID: unset
code: '200'
description: Returns API metadata
content:
application/json:
externalValue: ./examples/Time_off_request_summaries_-_Meta_Custom_Example_timeOffRequestSummary.read_200_575069.json
description: Time off request summaries - Meta
visibilityCodes:
- internal
- external
globalViewDevPortalIndicator: true
responses:
'200':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Returns API metadata
content:
application/json:
schema:
$ref: ./schemas/timeOffRequestSummaries_meta_schema_v03_00_rev001.json
'400':
$ref: '#/components/responses/400'
'500':
$ref: '#/components/responses/500'
'401':
$ref: '#/components/responses/401'
'412':
$ref: '#/components/responses/412'
'413':
$ref: '#/components/responses/413'
'403':
$ref: '#/components/responses/403'
'304':
$ref: '#/components/responses/304'
'404':
$ref: '#/components/responses/404'
'503':
$ref: '#/components/responses/503'
'405':
$ref: '#/components/responses/405'
'504':
$ref: '#/components/responses/504'
'406':
$ref: '#/components/responses/406'
'429':
$ref: '#/components/responses/429'
operationId: 04b981a3-253d-48d3-b647-abdaa5a9bf1f
description: Returns API metadata
parameters:
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: path
name: aoid
description: Associate OID
x-adpParameterData:
visibilityCodes:
- internal
- external
required: true
- schema:
default: ''
type: string
in: query
name: $filter
description: 'The OData $filter parameter MUST be used to specify the filter criterion. Please refer "RESTful Web
API Design Standard" for more details. Example: /core/v1/associates/{aoid}/documents?$filter=(documents/modifiers/modifierAOID
eq ‘G2O73G9Z62SL2NF2’ or documents/fileTypeCode/codeValue eq ‘xls’) and documents/categoryCode/codeValue eq ‘1006003’'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_userdn
description: 'SiteMinder user LDAP distinguished name. Required for requests where conversation was initiated from
a service consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_userdn: uid=JJohns@Abc,ou=Users,o=Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORUri
description: Actual Uri within the SOR
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_user
description: 'SiteMinder user ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_user: JJohns@Abc'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ConsumerAppOID
description: Identifier for the service consumer application. This header is required, if the actor (Service Consumer)
is an application or the actor is internal to ADP
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Context-ExpressionID
description: Geopolitical context, typically country, region, e.g. country=CA;subdivision=Quebec
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-OrgOID
description: Org OID for organization of the associate that is the actor in ' On Behalf Of' as provisioned by the
ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: G4O73G9Z62SL2NFM
type: string
in: header
name: associateoid
description: Associate OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: Authorization
description: Provides the client's authorization token to access the resource representation at a URI
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SOR
description: SOR where the call is routed to - usuall injected by the API proxy, with few exceptions
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: sm_transactionid
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ISI
type: string
in: header
name: realm
description: The identity management realm, e.g. ISI
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-Acting-SessionID
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-OrgOID
description: Org OID for organization of the associate that is the actor in 'Acting As' as provisioned by the ADP
Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Act-As-AssociateOID
description: Associate OID of the associate that is the actor in 'Acting As' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: employee
type: string
enum:
- employee
- ' manager'
- ' practitioner'
- ' administrator'
- ' supervisor'
in: header
name: roleCode
description: 'The role the user is playing during the transaction. Possible values: employee,manager,practitioner,administrator,supervisor. The
roleCode header should be passed in all calls.'
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: sm_auth_level
description: 'SiteMinder autorization level. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_auth_level: 10'
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: SORContext
description: Context within an SOR that the call should be routed to
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: ADP-Consumer-ApplicationID
description: Identifier of the application sending a request - not intended to be used as a correlation id for messages
across systems participating in a collaboration
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: orgoid
description: Organization OID of the requestor as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: true
- schema:
default: ''
type: string
in: header
name: ADP-On-Behalf-Of-AssociateOID
description: Associate OID for the associate that is the actor in ' On Behalf Of' as provisioned by the ADP Registry
x-adpParameterData:
visibilityCodes:
- internal
required: false
- schema:
default: ''
type: string
in: header
name: sm_serversessionid
description: 'SiteMinder session ID. Required for requests where conversation was initiated from a service consumer,
external to ADP, and that consumer was authenticated by SMS. Example - sm_serversessionid: SoFpy8UMyhtXY6YsEumvXJbznFA='
x-adpParameterData:
visibilityCodes:
- internal
required: false
tags:
- Worker Time Off Requests
components:
responses:
'400':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Bad Request
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'412':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Precondition Failed
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'500':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Internal Server Error
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'204':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Content-Type:
schema:
type: string
description: 'Content-Type'' '': '' type ''/'' subtype. Describes the media type and subtype of an entity-body.'
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: No Content
'413':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Request Entity Too Large
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'403':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Forbidden
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'304':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Not Modified
'404':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Not Found
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'503':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Service Unavailable
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'504':
description: Gateway Timeout
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'405':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Method Not Allowed
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'406':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Not Acceptable
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json
'429':
headers:
ADP-Acting-Session-Expires:
schema:
type: string
description: Specifies the date and time the representational state of the resource is considered stale in 'Act-As'
and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
Cache-Control:
schema:
type: string
description: Specifies directives that must be obeyed by all caching mechanisms along the request/response chain.
x-adpParameterData:
visibilityCodes:
- internal
required: false
sm_transactionid:
schema:
type: string
description: 'SiteMinder transaction ID. Required for requests where conversation was initiated from a service
consumer, external to ADP, and that consumer was authenticated by SMS. Example - sm_transactionid: 1aaf14ac-7083-54c0186f-4680c940-82b33ca3'
x-adpParameterData:
visibilityCodes:
- internal
required: false
ETag:
schema:
type: string
description: Defines the entity tag for use with the If-Match and If-None-Match request headers.
x-adpParameterData:
visibilityCodes:
- internal
required: false
ADP-Acting-SessionID:
schema:
type: string
description: Session ID for the acting session in 'Act-As' and act 'On-Behalf-Of' scenarios
x-adpParameterData:
visibilityCodes:
- internal
required: false
description: Too Many Requests
content:
application/json:
schema:
$ref: ../../../common/responses/v1/schemas/confirmMessage_schema_v01_00_rev008.json