1. REST API for Oracle Fusion Cloud HCM
  2. Tasks
  3. Workers
  4. Visa Permits

Get all worker visas permits

get

/hcmRestApi/resources/11.13.18.05/workers/{workersUniqID}/child/visasPermits

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Workers resource and used to uniquely identify an instance of Workers. The client should not generate the hash key value. Instead, the client should query on the Workers collection resource in order to navigate to a specific instance of Workers 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>
  • This query parameter is used to fetch resources which are effective dated as of the specified start date. The value of this query parameter is a string having a date in yyyy-MM-dd format
  • 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
  • Used as a predefined finder to search the collection.

    Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables

    • PrimaryKey Finds all the worker visa permits that match the specified primary key criteria.
      Finder Variables
      • EffectiveEndDate; string; End date of the date-effective changes to the record.
      • EffectiveStartDate; string; Start date of the date-effective changes to the record.
      • VisaPermitId; integer; Surrogate identifier for the worker's visa permit.
    • findByVisaPermitId Finds all the worker visa permits that match the specified criteria.
      Finder Variables
      • SysEffectiveDate; object;
      • VisaPermitId; integer; Surrogate identifier for the visa or permit.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • 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
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EmailAddressId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ReligionId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AssignGradeStepId; integer; Surrogate identifier for the assignment grade step record.
    • CreatedBy; string; User who created the grade step.
    • CreationDate; string; Date and time when the grade step was created.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • GradeStepId; integer; Surrogate identifier for the grade step.
    • GradeStepName; string; Name of the grade step. Valid values are defined in the gradeStepNamesLOV.
    • LastUpdateDate; string; User who last updated the grade step.
    • LastUpdatedBy; string; Date and time when the grade step was last updated.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • PhotoName; string; Name of the image file.
    • PhotoType; string; Type of photo such as Profile or Cover. Valid values are defined in the commonLookupsLOV.
    • PrimaryFlag; boolean; Indicates whether the image is primary.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ExpirationDate; string; Expiration date of the passport.
    • IssuingCountry; string; Country in which the passport was issued. Valid values are defined in the hcmCountriesLov.
    • IssuingCountryName; string; Name of the country issuing the person's passport.
    • PassportId; integer; Surrogate identifier for the passport.
    • PassportNumber; string; Passport number of the person.
    • PassportType; string; Type or category of the passport. Valid values are defined in the commonLookupsLOV.
    • PassportTypeMeaning; string; Meaning of the person's passport type.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AsgResponsibilityId; integer; Surrogate identifier for the responsibility.
    • AssignmentId; integer; Internal identifier for the representative's assignment.
    • AssignmentName; string; Name of the person's assignment.
    • AssignmentNumber; string; Assignment number of the representative.
    • DisplayName; string; Display name of the representative.
    • PersonId; integer; Internal identifier for the representative.
    • PersonNumber; string; Person number of the representative.
    • ResponsibilityName; string; Name of the area of responsibility of the representative such as Benefits Representative.
    • ResponsibilityType; string; Responsibility type of the representative such as Human Resource Representative.
    • Usage; string; Description of the purpose for the responsibility.
    • WorkContactsFlag; boolean; Indicates whether the representatives should be displayed.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EffectiveEndDate; string
    • EffectiveStartDate; string
    • PersonAddrUsageId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ImageId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • DeliveryMethodId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AddressId; integer; Surrogate identifier for the address record.
    • AddressType; string; Type of address. Valid values are defined in the commonLookupsLOV.
    • AddressTypeMeaning; string; Meaning of the person's address type.
    • Building; string; Building information associated with the address.
    • Country; string; Country in which the address is located. Valid values are defined in the hcmCountriesLov.
    • CountryName; string; Name of the country in which the person's address is located.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • FloorNumber; string; Floor number associated with the building.
    • Latitude; number; Distance between the equator and an address located to its north or south, expressed in degrees and minutes.
    • LongPostalCode; string; Long postal code of the primary mail address.
    • Longitude; number; Distance between the prime meridian and an address located to its east or west, expressed in degrees and minutes.
    • PersonAddrUsageId; integer; Surrogate identifier for the address usage record.
    • PostalCode; string; Postal code of the primary mail address.
    • PrimaryFlag; boolean; Indicates whether the address is the primary mailing address.
    • Provider; string; Company that has validated the address.
    • Region1; string; Primary region in which the address is located.
    • Region2; string; Secondary region within the primary region.
    • Region3; string; Additional secondary region within the primary region.
    • TownOrCity; string; Town or city in which the address is located.
    • ValidationStatusCode; string; Level of accuracy of an address, as determined by an address provider.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • Ethnicity; string; Person's ethnicity. Valid values are defined in the commonLookupsLOV.
    • EthnicityId; integer; Surrogate identifier for the person's ethnicity.
    • EthnicityMeaning; string; Meaning of the person's ethnicity.
    • LegislationCode; string; Legislation code of the ethnicity. Valid values are defined in the hcmCountriesLov.
    • LegislationName; string; Name of the person's legislation.
    • PrimaryFlag; boolean; Indicates whether the ethnicity is the primary ethnicity record for the person.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • CreationDate; string; Date and time when the supervisor record was created.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • LastUpdateDate; string; User who last updated the supervisor record.
    • ManagerAssignmentId; integer; Surrogate identifier for the assignment supervisor.
    • ManagerAssignmentNumber; string; Assignment number of the supervisor.
    • ManagerType; string; Role the supervisor has with regards to the overall organization structure such as functional, project leader, and so on. Valid values are defined in the commonLookupsLOV.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • DisplayName; string; Person's display name.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • FirstName; string; Person's first name.
    • FullName; string; Person's full name.
    • Honors; string; Higher qualification appended to a person's name such as PhD.
    • KnownAs; string; Person's preferred name.
    • LastName; string; Person's last name.
    • LegislationCode; string; Legislation code. Valid values are defined in the hcmCountriesLov.
    • LegislationName; string; Name of the person's legislation.
    • ListName; string; Person's listed name.
    • LocalCreatedBy; string; User who created the local name information.
    • LocalCreationDate; string; Date and time when the local name information was created.
    • LocalDisplayName; string; Person's display name in local language.
    • LocalEffectiveEndDate; string; End date of the date-effective changes to the record.
    • LocalEffectiveStartDate; string; Start date of the date-effective changes to the record.
    • LocalFirstName; string; Person's first name in local language.
    • LocalFullName; string; Person's full name in local language.
    • LocalHonors; string; Higher qualification appended to a person's name such as PhD in local language.
    • LocalKnownAs; string; Person's preferred name in local language.
    • LocalLastName; string; Person's last name in local language.
    • LocalLastUpdateDate; string; Date and time when the local name information was last updated.
    • LocalLastUpdatedBy; string; User who last updated the local name information.
    • LocalLegislationCode; string; Legislation code of the local language. Valid values are defined in the hcmCountriesLov.
    • LocalLegislationName; string; Name of the person's legislation in local language.
    • LocalListName; string; Person's listed name in local language.
    • LocalMiddleNames; string; Person's middle name in local language.
    • LocalMilitaryRank; string; Person's military rank in local language.
    • LocalNameInformation1; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation10; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation11; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation12; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation13; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation14; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation15; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation16; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation17; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation18; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation19; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation2; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation20; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation21; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation22; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation23; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation24; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation25; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation26; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation27; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation28; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation29; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation3; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation30; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation4; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation5; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation6; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation7; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation8; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameInformation9; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • LocalNameLanguage; string; Local language of the name. This isn't required for global names. If you're creating a local name, you must provide the language code.
    • LocalNameLanguageMeaning; string; Meaning of the local language code for the person's name.
    • LocalOrderName; string; Person's order name in local language.
    • LocalPersonNameId; integer; Surrogate identifier for the local name record.
    • LocalPreNameAdjunct; string; Part of the name added before a person's first name in local language.
    • LocalPreviousLastName; string; Person's previous last name in local language.
    • LocalSuffix; string; Part of the name appended to a person's last name such as Jr., III, and so on, in local language.
    • LocalTitle; string; Person's salutation such as Mr., Ms., and so on in local language. Valid values are defined in the commonLookupsLOV.
    • LocalTitleMeaning; string; Meaning of the person's title in local language.
    • MiddleNames; string; Person's middle name.
    • MilitaryRank; string; Person's military rank.
    • NameInformation1; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation10; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation11; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation12; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation13; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation14; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation15; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation16; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation17; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation18; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation19; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation2; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation20; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation21; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation22; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation23; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation24; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation25; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation26; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation27; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation28; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation29; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation3; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation30; string; Additional name attribute reserved for customer legislation-specific name requirements as defined in the person name style definition.
    • NameInformation4; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation5; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation6; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation7; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation8; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameInformation9; string; Additional name attribute reserved for Oracle Development for legislation-specific name requirements as defined in the person name style definition.
    • NameLanguage; string; Language of the name. This isn't required for global names. If you're creating a local name, you must provide the language code.
    • NameLanguageMeaning; string; Meaning of the language code for the person's name.
    • OrderName; string; Person's order name.
    • PersonNameId; integer; Surrogate identifier for the name record.
    • PreNameAdjunct; string; Part of the name added before a person's first name.
    • PreviousLastName; string; Person's previous last name.
    • Suffix; string; Part of the name appended to a person's last name such as Jr., III, and so on.
    • Title; string; Person salutation such as Mr., Ms., and so on. Valid values are defined in the commonLookupsLOV.
    • TitleMeaning; string; Meaning of the person's title.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EffectiveEndDate; string
    • EffectiveStartDate; string
    • PersonLegislativeId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EffectiveEndDate; string
    • EffectiveStartDate; string
    • VisaPermitId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • LegalEmployerName; string; Name of the legal employer for the work relationship.
    • LegalEntityId; integer; Unique identifier for the legal entity of the work relationship.
    • LegislationCode; string; Legislation associated with the period of service.
    • PeriodOfServiceId; integer; Surrogate identifier for the period of service.
    • PrimaryFlag; boolean; Indicates whether the work relationship is the primary work relationship for the worker. Valid values are Yes and No.
    • ProjectedTerminationDate; string; Projected last date of employment for the period of service.
    • ReadyToConvertFlag; boolean; Indicates whether the pending worker is ready to be converted to the proposed worker type.
    • StartDate; string; Start date of the period of employment.
    • TerminationDate; string; Last date of employment for this period of service.
    • WorkerType; string; Worker type for the period of service such as Employee (E), Contingent Worker (C), Pending Worker (P), or Nonworker (N). Valid values are defined in the commonLookupsLOV.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AreaCode; string; Area code of the phone number.
    • CountryCodeNumber; string; Country code of the phone number. Valid values are defined in the hcmCountriesLov.
    • Extension; string; Extension number for the phone.
    • LegislationCode; string; Phone legislation code.
    • LegislationName; string; Name of the person's legislation.
    • PhoneId; integer; Surrogate identifier for the phone.
    • PhoneNumber; string; Phone number of various phone types such as Work, Home, and so on.
    • PhoneType; string; Type of phone such as Work, Home, and so on. Valid values are defined in the commonLookupsLOV.
    • PhoneTypeMeaning; string; Meaning of the person's phone type.
    • PrimaryFlag; boolean; Indicates whether the phone number is the primary phone of the worker.
    • ToDate; string; Date until when the phone number is valid.
    • Validity; string; Time of day when a person can be reached at a specific phone number.
    • ValidityMeaning; string; Description of the phone validity. Valid values are defined in the commonLookupsLOV.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • FromDate; string; Date from when the message is effective.
    • MessageContent; string; Content of the message notification.
    • MessageId; integer; Surrogate identifier for the worker message.
    • ToDate; string; Date until when the message is effective.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EmailAddress; string; Email address of the person.
    • EmailAddressId; integer; Surrogate identifier for the email address of a worker.
    • EmailType; string; Type of email such as work, personal, and so on. Valid values are defined in the commonLookupsLOV.
    • EmailTypeMeaning; string; Meaning of the person's email type.
    • PrimaryFlag; boolean; Indicates whether the email is the person's primary email.
    • ToDate; string; Date until when the email address is valid.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ApplicantNumber; string; Applicant number in the external application.
    • BloodTypeMeaning; string; Meaning of the blood type of the person.
    • CorrLanguageMeaning; string; Meaning of the person's preferred language of communication.
    • CountryOfBirthName; string; Name of the country of birth of the person.
    • DateOfBirth; string; Date of birth of the person.
    • DisplayName; string; Person's display name.
    • FullName; string; Person's full name.
    • ListName; string; Person's list name.
    • PersonId; integer; Surrogate identifier for the person.
    • PersonNumber; string; Number assigned to a person to identify the person uniquely. Doesn't depend on the person type such as employee, contingent worker, and so on.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AccommodationRequest; string; Request for accommodation.
    • Category; string; Category of the disability such as Physical or Intellectual.
    • CreatedBy; string; User who created the disability record.
    • CreationDate; string; Date and time when the disability record was created.
    • Degree; number; Extent to which the disability impacts the person's abilities.
    • Description; string; Description of the person's disability.
    • DisabilityCode; string; Code for the disability.
    • DisabilityId; integer; Surrogate identifier for the disability of a worker.
    • DisclosureDate; string; Date on which the disability has been disclosed by the worker. Used explicitly for the Japanese, United Kingdom, and United States legislation.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • LastUpdateDate; string; Date and time when the disability record was last updated.
    • LastUpdatedBy; string; User who last updated the disability record.
    • LegislationCode; string; Legislation code for the disability. Valid values are defined in the hcmCountriesLov.
    • OrganizationId; integer; Unique identifier of the organization.
    • OrganizationName; string; Organization name to which the disability is registered.
    • QuotaFTE; number; Person's full time equivalency.
    • Reason; string; Reason for the person's disability.
    • RegistrationDate; string; Date on which the disability was registered with the disability organization.
    • RegistrationExpDate; string; Expiration date of the disability registration.
    • RegistrationId; string; Identification detail given to the person by the disability organization.
    • SelfDisclosedType; string; Type of disability disclosed by the worker. Used explicitly for the Japanese, United Kingdom, and United States legislation.
    • Status; string; Status of the person's disability.
    • WorkRestriction; string; Details of any work restrictions due to the disability.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AssignmentId; integer; Internal identifier for the reports assignment.
    • AssignmentName; string; Business title of the report.
    • AssignmentNumber; string; Assignment number of the report.
    • DisplayName; string; Display name of the report.
    • Level; integer; Level of the report in the manager's hierarchy.
    • PersonId; integer; Surrogate identifier for the report.
    • PersonNumber; string; Person number of the report.
    • RelationshipType; string; Type of managerial relationship with the report such as line manager.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AssignmentId; integer
    • AssignmentType; string
    • EffectiveEndDate; string
    • EffectiveLatestChange; string
    • EffectiveSequence; integer
    • EffectiveStartDate; string
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • LegislationCode; string; Religion legislation code. Valid values are defined in the hcmCountriesLov.
    • LegislationName; string; Name of the person's legislation.
    • PrimaryFlag; boolean; Indicates whether the religion is the person's primary religion for this legislation.
    • Religion; string; Religion of the person. Valid values are defined in the commonLookupsLOV.
    • ReligionId; integer; Surrogate identifier for the religion.
    • ReligionMeaning; string; Meaning of the person's religion code.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ContractId; integer
    • EffectiveEndDate; string
    • EffectiveStartDate; string
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • NationalIdentifierId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • DriversLicenseId; integer; Surrogate identifier for the driver's license of a worker.
    • IssuingCountry; string; Country in which the driver's license was issued. Valid values are defined in the hcmCountriesLov.
    • IssuingCountryName; string; Name of the country issuing the person's license.
    • LicenseNumber; string; Driver's license number.
    • LicenseSuspendedFlag; boolean; Indicates whether the driver's license is suspended.
    • LicenseType; string; Type of license. Valid values are defined in the commonLookupsLOV.
    • LicenseTypeMeaning; string; Meaning of the person's license type.
    • SuspendedFromDate; string; Start date of suspension period, if any.
    • SuspendedToDate; string; End date of suspension period, if any.
    • ToDate; string; Date until when the driver's license is valid.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • PeriodOfServiceId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ActionCode; string; Action being performed for this assignment, such as, Hire, Add Pending Worker, Manager Change and so on. Valid values are defined in the actionsLOV.
    • AssignmentCategory; string; User-defined category for the assignment such as full-time, permanent, and so on. Valid values are defined in the commonLookupsLOV.
    • AssignmentId; integer; Surrogate identifier for the worker assignment.
    • AssignmentName; string; Business title of the worker assignment.
    • AssignmentNumber; string; Unique identifier for the assignment.
    • AssignmentStatusType; string; Assignment status type. Valid values are defined in the assignmentStatusTypesLov.
    • AssignmentType; string; Type of the assignment such as employee or contingent worker.
    • BargainingUnitCode; string; Code for the bargaining unit.
    • BusinessUnitId; integer; Unique identifier for the business unit of the assignment.
    • BusinessUnitName; string; Name of the business unit for the worker assignment. Valid values are defined in the hcmBusinesUnitsLOV.
    • CollectiveAgreementId; integer; Surrogate identifier for the collective agreement.
    • CollectiveAgreementName; string; Name for the collective agreement. Valid values are defined in the collectiveAgreementsLov.
    • ContractId; integer; Surrogate identifier for the contract.
    • ContractNumber; string; Number of the contract.
    • DefaultExpenseAccount; string; Default expense account of the assignment. If the expense account is configured with multiple segments, then provide the concatenated value. Separate the values using the separator configured for the expense account.
    • DepartmentId; integer; Unique identifier for the worker's department.
    • DepartmentName; string; Name of the department for the worker assignment. Valid values are defined in the departmentsLov.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveLatestChange; string; Set to Y if this is the last change on the effective start date. Otherwise, set to N.
    • EffectiveSequence; integer; Sequence number of the change on the effective start date. For the first change on the effective start date, set this value to 1. For incremental changes, leave this value blank to generate the next number in the sequence.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • FullPartTime; string; Indicates whether the worker works full-time or part-time. Valid values are defined in the commonLookupsLOV.
    • GradeCode; string; Code of the assignment grade. Valid values are defined in the gradesLov.
    • GradeId; integer; Unique identifier for the worker's grade.
    • GradeLadderId; integer; Unique identifier for the grade ladder used for benefits.
    • GradeLadderName; string; Name of the grade ladder used for benefits. Valid values are defined in the gradeLaddersLov.
    • GradeStepEligibilityFlag; boolean; Indicates whether the assignment is eligible for grade-step progression. Valid values are true or false.
    • HourlySalariedCode; string; Identifies whether the assignment is paid by the hour or by a salary. Either maintained at the assignment level or employment or placement terms but not both. Valid values are defined in the commonLookupsLOV.
    • JobCode; string; Code for the worker's job. Valid values are defined in the jobsLov.
    • JobId; integer; Unique identifier for the worker's job.
    • LabourUnionMemberFlag; boolean; Indicates whether the worker is a labor union member.
    • LocationCode; string; Code for the worker's location.
    • LocationId; integer; Unique identifier for the worker's location.
    • ManagerFlag; boolean; Indicates whether the worker is a manager.
    • NoticePeriod; integer; Notice period for the assignment. Specify with the NoticePeriodUOM attribute.
    • NoticePeriodUOM; string; Unit of measure for the notice period. Specify with the NoticePeriod attribute. Valid values are defined in the commonLookupsLOV.
    • PeopleGroup; string; People Group Key flexfield for the assignment. If people group is configured with multiple segments, provide the concatenated value, separating the values with the separator configured for the People Group Key flexfield.
    • PermanentTemporary; string; Indicates whether the worker is regular or temporary. Valid values are defined in the commonLookupsLOV.
    • PositionCode; string; Code for the worker's position.
    • PositionId; integer; Unique identifier for the worker's position.
    • PrimaryAssignmentFlag; boolean; Indicates whether the current assignment is primary for the work relationship. Valid values are true or false.
    • PrimaryFlag; boolean; Indicates whether the current assignment is the primary assignment for the worker. Valid values are true or false.
    • ProbationEndDate; string; End date of the probation period.
    • ProbationPeriod; number; Duration of the probation period. Specify with the ProbationPeriodUnit attribute.
    • ProbationPeriodUnit; string; Unit of measure for the probation period. Specify with the ProbationPeriod attribute. Valid values are defined in the commonLookupsLOV.
    • ProjectedEndDate; string; Date when the assignment is expected to end.
    • ProjectedStartDate; string; Expected start date for applicants. This value is required for pending workers.
    • ProposedUserPersonType; string; Code of the proposed user person type. Valid values are defined in the personTypesLOV.
    • ProposedUserPersonTypeId; string; Unique identifier for the proposed user person type.
    • ReportingEstablishmentId; integer; Unique identifier for the reporting establishment.
    • ReportingEstablishmentName; string; Name of the reporting establishment. Valid values are defined in the reportingEstablishmentsLOV.
    • RetirementAge; integer; Age at which the worker is retiring.
    • RetirementDate; string; Planned retirement date of the worker.
    • SeniorityBasis; string; Basis for calculating seniority for the person. Valid values are defined in the commonLookupsLOV.
    • SynchronizeFromPositionFlag; boolean; Indicates whether attributes from the position can be overridden on the assignment when using position synchronization. Valid values are true or false.
    • UnionId; integer; Unique identifier of the worker union for the assignment.
    • UnionName; string; Name of the worker union for the assignment. Valid values are defined in the unionsLov.
    • UserPersonTypeId; integer; Unique identifier for the user person type.
    • WorkAtHomeFlag; boolean; Indicates whether the worker works at home for the assignment.
    • WorkerCategory; string; Category of the worker such as blue collar, civil servant, and so on. Valid values are defined in the commonLookupsLOV.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AccountName; string; Name of the account.
    • DeliveryMethodId; integer; Surrogate identifier for the delivery method.
    • EndDate; string; End date of the account.
    • Provider; string; Provider of the account such as Facebook and Twitter. Valid values are defined in the commonLookupsLOV.
    • ProviderMeaning; string; Meaning of the person's provider type.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • Citizenship; string; Citizenship legislation code. Valid values are defined in the hcmCountriesLov.
    • CitizenshipId; integer; Surrogate identifier for the citizenship of a worker.
    • CitizenshipMeaning; string; Name of the citizenship legislation code.
    • CitizenshipStatus; string; Status of the citizenship. Valid values are defined in the commonLookupsLOV.
    • CitizenshipStatusMeaning; string; Meaning of the person's citizenship status code.
    • ToDate; string; Date until when the citizenship is valid.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AssignmentId; integer; Unique identifier of the assignment to which this external identifier relates.
    • AssignmentName; string; Name of the person's assignment.
    • AssignmentNumber; string; Assignment number to which the external identifier belongs.
    • ExternalIdentifierId; integer; Surrogate identifier for the external identifier.
    • ExternalIdentifierNumber; string; External identifier number.
    • ExternalIdentifierSequence; integer; Sequence of the external identifier.
    • ExternalIdentifierType; string; Type of external identifier, such as Third-Party Payroll ID. Valid values are defined in the commonLookupsLOV.
    • ExternalIdentifierTypeMeaning; string; Meaning of the person's external identifier.
    • FromDate; string; Date and time from when the external identifier is valid.
    • ToDate; string; Date and time until when the external identifier is valid.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • ExpirationDate; string; Expiration date of the visa or permit.
    • IssuingCountry; string; Country in which the visa or permit was issued. Valid values are defined in the hcmCountriesLov.
    • IssuingCountryName; string; Name of the country issuing the person's visa.
    • VisaPermitCategory; string; Category of the visa or permit. Valid values are defined in the commonLookupsLOV.
    • VisaPermitCategoryMeaning; string; Meaning of the person's visa permit category.
    • VisaPermitId; integer; Surrogate identifier for the visa or permit.
    • VisaPermitNumber; string; Visa or permit number.
    • VisaPermitStatus; string; Indicates if the visa or permit is current. Valid values are defined in the commonLookupsLOV.
    • VisaPermitStatusDate; string; Date from when the permit status is effective.
    • VisaPermitStatusMeaning; string; Meaning of the person's visa permit status.
    • VisaPermitType; string; Visa or permit type. Valid values are defined in the commonLookupsLOV.
    • VisaPermitTypeMeaning; string; Meaning of the person's visa permit type.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • ActionCode; string; Action code for the employment contract.
    • ContractEndDate; string; Date when the contract ends.
    • ContractExtensionFlag; boolean; Indicates whether the contract should be extended. Valid values are Yes and No. The default value is null.
    • ContractId; integer; Surrogate identifier for the contract.
    • ContractNumber; string; Number of the contract.
    • ContractType; string; Type of the contract.
    • EffectiveEndDate; string; End date of the date-effective changes to the record.
    • EffectiveStartDate; string; Start date of the date-effective changes to the record.
    • ExtensionNumber; integer; Extension number of the contract.
    • ExtensionPeriod; number; Extension period of the contract.
    • ExtensionPeriodUnits; string; Unit for the extension period of the contract.
    • InitialDuration; number; Initial duration of the contract.
    • InitialDurationUnits; string; Unit for the initial duration of the contract.


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • CitizenshipId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • DriversLicenseTypeId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string


    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • PhoneId; integer
    • __FLEX_Context; string
    • __FLEX_Context_DisplayValue; string
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
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 : workers-visasPermits
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : workers-visasPermits-item-response
Type: object
Show Source
Nested Schema : visasPermitsDDF
Type: array
Show Source
  • Discriminator: __FLEX_Context
    Discriminator: { "propertyName":"__FLEX_Context", "mapping":{ "AE":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFAEVO-item-response", "CH":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFCHVO-item-response", "KW":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFKWVO-item-response", "ORA_HRX_BH":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FBHVO-item-response", "ORA_HRX_OM":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FOMVO-item-response", "ORA_HRX_QA":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FQAVO-item-response", "SA":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFSAVO-item-response", "SG":"#/components/schemas/oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFSGVO-item-response" } }
Nested Schema : visasPermitsDFF
Type: array
Show Source
Nested Schema : Discriminator: __FLEX_Context
Type: object
Discriminator: __FLEX_Context

Discriminator Values

Match One Schema
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFAEVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFCHVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFKWVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FBHVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FOMVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFORA__5FHRX__5FQAVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFSAVO-item-response
Type: object
Show Source
Nested Schema : oracle_apps_hcm_people_core_flex_personVisaLegDDF_view_PersonVisaLegDDFSGVO-item-response
Type: object
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Links
Type: array
Title: Links
The link relations associated with the resource instance.
Show Source
Nested Schema : workers-visasPermits-visasPermitsDFF-item-response
Type: object
Show Source
Back to Top

Examples

The following example shows how to retrieve all the worker visas permits by submitting a GET request on the REST resource using cURL.

curl -i -u "<username>:<password>" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -H "REST-Framework-Version: 4" -X GET "https://<host>:<port>/hcmRestApi/resources/11.13.18.05/workers/00020000000EACED0005770800005AF3116303090000004AACED00057372000D6A6176612E73716C2E4461746514FA46683F3566970200007872000E6A6176612E7574696C2E44617465686A81014B597419030000787077080000016ABDF0400078/child/visasPermits"

Example of Response Header

The following is an example of the response header.

Status: HTTP/1.1 200 OK
Content-Type : application/vnd.oracle.adf.resourceitem+json

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
    "items": [
        {
            "VisaPermitId": 300100186928126,
            "EffectiveStartDate": "2018-01-01",
            "EffectiveEndDate": "4712-12-31",
            "IssuingCountry": "US",
            "VisaPermitType": null,
            "VisaPermitCategory": null,
            "VisaPermitNumber": null,
            "VisaPermitStatus": null,
            "IssuingAuthority": null,
            "IssuingLocation": null,
            "IssueDate": null,
            "EntryDate": null,
            "ExpirationDate": null,
            "VisaPermitStatusDate": null,
            "Profession": null,
            "CreatedBy": "VMOSS",
            "CreationDate": "2019-05-16T09:18:45+00:00",
            "LastUpdatedBy": "VMOSS",
            "LastUpdateDate": "2019-05-16T09:18:45.954+00:00",
            "links": [
               {...
                 }
   ]
}
Back to Top