Get an area of responsibility

get

/hcmRestApi/resources/11.13.18.05/areasOfResponsibility/{areasOfResponsibilityUniqID}

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Areas of Responsibility resource and used to uniquely identify an instance of Areas of Responsibility. The client should not generate the hash key value. Instead, the client should query on the Areas of Responsibility collection resource in order to navigate to a specific instance of Areas of Responsibility to get the hash key.
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • This header accepts a string value. The string is a semi-colon separated list of =. It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers.
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : areasOfResponsibility-item-response
Type: object
Show Source
  • Title: Status
    Maximum Length: 30
    Status of the area of responsibility whether active or inactive.
  • Title: Assignment Category Code
    Maximum Length: 30
    Code of the assignment category, which is used in defining the responsibility scope.
  • Title: Assignment Category
    Read Only: true
    Maximum Length: 80
    Category of the assignment, which is used in defining the responsibility scope.
  • Title: Assignment ID
    Unique identifier of the assignment assigned to the area of responsibility.
  • Title: Business Title
    Read Only: true
    Maximum Length: 80
    Business title of the person assigned to the responsibility.
  • Title: Assignment Number
    Maximum Length: 30
    Unique number of the assignment assigned to the area of responsibility.
  • Banner Override Messages
    Title: Banner Override Messages
    The bannerOverrideMessages resource provides all the status information and related messages for an object.
  • Title: Bargaining Unit
    Read Only: true
    Maximum Length: 80
    Name of the bargaining unit, which is used in defining the responsibility scope.
  • Title: Bargaining Unit Code
    Maximum Length: 30
    Code of the bargaining unit, which is used in defining the responsibility scope.
  • Title: Benefit Group ID
    Surrogate identifier for the benefit group, which is used in defining the responsibility scope.
  • Title: Benefit Group
    Maximum Length: 240
    Name of the benefit group, which is used in defining the responsibility scope.
  • Title: Business Unit ID
    Unique identifier for the business unit, which is used in defining the responsibility scope.
  • Title: Business Unit
    Maximum Length: 240
    Short code of the business unit, which is used in defining the responsibility scope.
  • Title: Country
    Read Only: true
    Maximum Length: 80
    Name of the country, which is used in defining the responsibility scope.
  • Title: Country Code
    Maximum Length: 30
    Code of the country, which is used for defining the responsibility scope, such as US.
  • Read Only: true
    Maximum Length: 64
    User who created the area of responsibility.
  • Read Only: true
    Date when the area of responsibility was created.
  • Title: Department ID
    Unique identifier for the department, which is used in defining the responsibility scope.
  • Title: Department
    Maximum Length: 240
    Name of the department, which is used in defining the responsibility scope.
  • Title: Department Tree Code
    Maximum Length: 30
    Code of the department tree code, which is used in defining the responsibility scope.
  • Title: Department Hierarchy
    Read Only: true
    Maximum Length: 80
    Name of the department hierarchy, which is used in defining the responsibility scope.
  • Title: Department Tree Version ID
    Maximum Length: 32
    Unique identifier for the department tree version, which is used in defining the responsibility scope.
  • Title: Department Tree Version Name
    Read Only: true
    Maximum Length: 80
    Name of the department hierarchy version, which is used in defining the responsibility scope.
  • Title: Person Name
    Read Only: true
    Maximum Length: 240
    Name of the person who is assigned to the responsibility.
  • Title: To Date
    Date when the area of responsibility is last active.
  • Title: Grade Code
    Maximum Length: 30
    Code of the grade, which is used in defining the responsibility scope.
  • Title: Grade ID
    Unique identifier for the grade, which is used in defining the responsibility scope.
  • Title: Grade
    Read Only: true
    Maximum Length: 240
    Name of the grade, which is used in defining the responsibility scope.
  • Title: Grade Set Code
    Maximum Length: 30
    Code of the grade set, which is used in defining the responsibility scope.
  • Title: Hierarchy Levels
    Number of levels in the hierarchy, which is used in defining the responsibility scope.
  • Title: Hierarchy Type Code
    Maximum Length: 30
    Code of the hierarchy type, which is used in defining the responsibility scope.
  • Title: Hierarchy Type
    Read Only: true
    Maximum Length: 80
    Name of the hierarchy type, which is used in defining the responsibility scope.
  • Title: Include Top Hierarchy Node
    Maximum Length: 30
    Indicates whether the top organization, department, position, or supervisor is included in the hierarchy, which is used in defining the responsibility scope. The default value is N.
  • Title: Job Code
    Maximum Length: 30
    Code of the job, which is used in defining the responsibility scope.
  • Title: Job Family Code
    Maximum Length: 240
    Code of the job family, which is used in defining the responsibility scope.
  • Title: Job Family ID
    Unique identifier for the job family, which is used in defining the responsibility scope.
  • Title: Job Family
    Read Only: true
    Maximum Length: 240
    Name of the job family, which is used in defining the responsibility scope. The job family code can also be used instead.
  • Title: Job Function Code
    Maximum Length: 30
    Code of the job function, which is used in defining the responsibility scope.
  • Title: Job Function
    Read Only: true
    Maximum Length: 80
    Meaning of the job function code.
  • Title: Job ID
    Unique identifier for the job, which is used in defining the responsibility scope.
  • Title: Job
    Read Only: true
    Maximum Length: 240
    Name of the job, which is used in defining the responsibility scope.
  • Title: Job Set Code
    Maximum Length: 30
    Code of the job set, which is used in defining the responsibility scope.
  • Title: To Last Name
    Maximum Length: 30
    Initial letter of the last name in the last name range. This is used in defining the responsibility scope. This value is supplied with LastNameStart.
  • Title: From Last Name
    Maximum Length: 30
    Initial letter of the last name in the last name range. This is used in defining the responsibility scope. This value is supplied with LastNameEnd.
  • Read Only: true
    Date when the area of responsibility was last updated.
  • Read Only: true
    Maximum Length: 64
    User who last updated the area of responsibility.
  • Title: Legal Employer
    Maximum Length: 240
    Name of the legal employer, which is used in defining the responsibility scope.
  • Title: Legal Entity ID
    Surrogate identifier for the legal entity, which is used in defining the responsibility scope.
  • Title: Legislative Data Group ID
    Unique identifier for the legislative data group, which is used in defining the responsibility scope.
  • Title: Legislative Data Group
    Maximum Length: 240
    Name of the legislative data group, which is used in defining the responsibility scope.
  • Links
  • Title: Location Code
    Maximum Length: 150
    Code of the location, which is used in defining the responsibility scope.
  • Title: Location ID
    Unique identifier for the location, which is used in defining the responsibility scope.
  • Title: Location
    Read Only: true
    Maximum Length: 60
    Name of the location, which is used in defining the responsibility scope.
  • Title: Location Set Code
    Maximum Length: 30
    Code of the location set, which is used in defining the responsibility scope.
  • Title: Organization Tree Code
    Maximum Length: 30
    Code of the organization tree, which is used in defining the responsibility scope.
  • Title: Organization Hierarchy
    Read Only: true
    Maximum Length: 80
    Name of the organization hierarchy, which is used in defining the responsibility scope.
  • Title: Organization Tree Version ID
    Maximum Length: 32
    Unique identifier for the organization tree version, which is used in defining the responsibility scope.
  • Title: Organization Tree Version Name
    Read Only: true
    Maximum Length: 80
    Name of the organization hierarchy version, which is used in defining the responsibility scope.
  • Title: Payroll ID
    Unique identifier for the payroll, which is used in defining the responsibility scope.
  • Title: Payroll Name
    Maximum Length: 80
    Name of the payroll, which is used in defining the responsibility scope.
  • Title: Payroll Statutory Unit ID
    Unique identifier for the payroll statutory unit, which is used in defining the responsibility scope.
  • Title: Payroll Statutory Unit
    Maximum Length: 240
    Name of the payroll statutory unit, which is used in defining the responsibility scope.
  • Title: Person ID
    Unique identifier of the person who is assigned to the responsibility.
  • Title: Person Number
    Read Only: true
    Maximum Length: 30
    Unique number of the person who is assigned to the responsibility.
  • Title: Position Code
    Maximum Length: 30
    Code of the position, which is used in defining the responsibility scope.
  • Title: Position ID
    Unique identifier for the position, which is used in defining the responsibility scope.
  • Title: Position
    Read Only: true
    Maximum Length: 240
    Name of the position, which is used in defining the responsibility scope.
  • Title: Position Tree Code
    Maximum Length: 30
    Code of the position tree, which is used in defining the responsibility scope.
  • Title: Position Hierarchy
    Read Only: true
    Maximum Length: 80
    Name of the position hierarchy, which is used in defining the responsibility scope.
  • Title: Position Tree Version ID
    Maximum Length: 32
    Unique identifier for the position tree version, which is used in defining the responsibility scope.
  • Title: Position Tree Version Name
    Read Only: true
    Maximum Length: 80
    Name of the position hierarchy version, which is used in defining the responsibility scope.
  • Title: Recruiting Location Hierarchy ID
    Surrogate identifier of the recruiting location hierarchy, which is used in defining the responsibility scope.
  • Title: Recruiting Location Hierarchy
    Maximum Length: 4000
    Name of the recruiting location hierarchy, which is used in defining the responsibility scope.
  • Title: Recruiting Organization Hierarchy ID
    Surrogate identifier of the recruiting organization hierarchy, which is used in defining the responsibility scope.
  • Title: Recruiting Organization Hierarchy
    Maximum Length: 240
    Name of the recruiting organization hierarchy, which is used in defining the responsibility scope.
  • Title: Recruiting Organization Tree Code
    Maximum Length: 1000
    Code of the recruiting organization tree, which is used in defining the responsibility scope.
  • Title: Recruiting Organization Tree Version
    Maximum Length: 1000
    Version of the recruiting organization hierarchy, which is used in defining the responsibility scope.
  • Title: Recruiting Type Code
    Maximum Length: 30
    Code of the recruiting type, which is used in defining the responsibility scope.
  • Title: Recruiting Type
    Read Only: true
    Maximum Length: 80
    Name of the recruiting type, which is used in defining the responsibility scope.
  • Title: Area of Responsibility ID
    Read Only: true
    Unique identifier for the area of responsibility. This is available only when updating an existing record.
  • Title: Responsibility Name
    Maximum Length: 240
    Name of the responsibility.
  • Title: Responsibility Type Code
    Maximum Length: 30
    Code that uniquely references the responsibility type.
  • Title: Responsibility Type
    Read Only: true
    Maximum Length: 80
    Type of responsibility, such as human resources representative or union representative.
  • Title: From Date
    Date when the area of responsibility is active.
  • Title: Tax Reporting Unit ID
    Unique identifier for the tax reporting unit, which is used in defining the responsibility scope.
  • Title: Tax Reporting Unit
    Maximum Length: 240
    Name of the tax reporting unit, which is used in defining the responsibility scope.
  • Title: Template Code
    Maximum Length: 30
    Code of the area of responsibility template.
  • Title: Template ID
    Unique identifier of the area of responsibility template.
  • Title: Template Name
    Read Only: true
    Maximum Length: 240
    Name of the area of responsibility template.
  • Title: Top Department ID
    Unique identifier for the top department in the department hierarchy, which is used in defining the responsibility scope.
  • Title: Top Department
    Maximum Length: 240
    Name of the top department in the hierarchy, which is used in defining the responsibility scope.
  • Title: Top Manager ID
    Unique identifier for the top manager in the supervisor hierarchy, which is used in defining the responsibility scope.
  • Title: Top Manager
    Read Only: true
    Maximum Length: 240
    Name of the top manager, which is used in defining the responsibility scope.
  • Title: Top Manager Number
    Maximum Length: 30
    Person number of the top manager in the supervisor hierarchy, which is used in defining the responsibility scope.
  • Title: Top Organization ID
    Unique identifier for the top organization in the organization hierarchy, which is used in defining the responsibility scope.
  • Title: Top Organization
    Maximum Length: 240
    Name of the top organization in the hierarchy for the responsibility scope.
  • Title: Top Position ID
    Unique identifier for the top position in the position hierarchy, which is used in defining the responsibility scope.
  • Title: Top Position
    Maximum Length: 240
    Name of the top position in the hierarchy, which is used in defining the responsibility scope.
  • Title: Usage
    Maximum Length: 4000
    Intended purpose for the responsibility.
  • Title: Work Contacts Flag
    Maximum Length: 30
    Default Value: true
    Indicates whether to include or exclude the person from work contacts or representatives. The default value is Yes.
Nested Schema : Banner Override Messages
Type: array
Title: Banner Override Messages
The bannerOverrideMessages resource provides all the status information and related messages for an object.
Show Source
Nested Schema : areasOfResponsibility-bannerOverrideMessages-item-response
Type: object
Show Source
Back to Top