Get all person profiles

get

/fscmRestApi/resources/11.13.18.05/searchHedPersonProfiles

Request

Query Parameters
  • 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 person profiles that match the Party ID, Party ID1, Person Profile ID, and Citizenship ID.
      Finder Variables:
      • PartyId; integer; Unique identifier for party. Party can be a person in Oracle Trading Community Architecture. For example, a student can be a party.
    • searchByKeywords: Keyword to search from Name, Email ID, and Constituent ID.
      Finder Variables:
      • keyword1; string.
      • keyword2; string.
  • 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:
    • AdditionalFirstName; string; The additional first name of a person.
    • AdditionalLastName; string; The additional last name of a person.
    • AdditionalMiddleName; string; The additional middle name of a person.
    • ConstituentId; string; The unique identifier for a constituent.
    • DisplayFirstName; string; The display first name of a person.
    • DisplayLastName; string; The display last name of a person.
    • EmailAddress; string; The email address of the person.
    • EmailId; integer; The unique identifier for an email address.
    • FirstName; string; The first name of a person.
    • FullName; string; The full name of the person.
    • Gendercode; string; The gender of the person, such as male, female, or unknown. A list of accepted values is defined in the lookup type ORA_HEY_GENDER.
    • Gendermeaning; string; The meaning of the gender code. A list of accepted values is defined in the lookup type ORA_HEY_GENDER.
    • LastName; string; The last name of a person.
    • MiddleName; string; The middle name of a person.
    • NameSuffix; string; The suffix can be junior or senior.
    • NameTypeCode; string; The type of the name. It is a value defined by the Additional Party Name and Identifier Type entity. A list of accepted values is defined in the lookup type ORA_HEY_NAME_TYPE.
    • PartyId; integer; The unique identifier for the party. Party can be a person. For example, a student can be a party.
    • PartyNameId; integer; The unique identifier for a name.
    • PreferredEmailFlag; boolean; Indicates the preferred email address.
    • PreferredNameFlag; boolean; Indicates the name as preferred name for this party within this name type.
    • PurposeCode; string; The type of purpose for email contact, such as work, emergency, and home. A list of accepted values is defined in the lookup type ORA_HEY_EMAIL_CONTACT_PURPOSE.
    • Title; string; The title of the person, such as Mr or Mrs.
  • 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
  • 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 : searchHedPersonProfiles
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : searchHedPersonProfiles-item-response
Type: object
Show Source
  • Title: First Name
    Read Only: true
    Maximum Length: 150
    The additional first name of a person.
  • Title: Last Name
    Read Only: true
    Maximum Length: 150
    The additional last name of a person.
  • Title: Middle Name
    Read Only: true
    Maximum Length: 60
    The additional middle name of a person.
  • Title: Constituent ID
    Read Only: true
    Maximum Length: 30
    The unique identifier for a constituent.
  • Read Only: true
    Maximum Length: 150
    The display first name of a person.
  • Read Only: true
    Maximum Length: 150
    The display last name of a person.
  • Title: Email
    Read Only: true
    Maximum Length: 320
    The email address of the person.
  • Read Only: true
    The unique identifier for an email address.
  • Title: First Name
    Read Only: true
    Maximum Length: 150
    The first name of a person.
  • Title: Full Name
    Read Only: true
    Maximum Length: 360
    The full name of the person.
  • Read Only: true
    Maximum Length: 30
    The gender of the person, such as male, female, or unknown. A list of accepted values is defined in the lookup type ORA_HEY_GENDER.
  • Read Only: true
    Maximum Length: 80
    The meaning of the gender code. A list of accepted values is defined in the lookup type ORA_HEY_GENDER.
  • Images
    Title: Images
    The images resource is a child of search person profiles resource and provides information about the image uploaded by the user.
  • Title: Last Name
    Read Only: true
    Maximum Length: 150
    The last name of a person.
  • Links
  • Title: Middle Name
    Read Only: true
    Maximum Length: 60
    The middle name of a person.
  • Title: Name Suffix
    Read Only: true
    Maximum Length: 30
    The suffix can be junior or senior.
  • Title: Name Type Code
    Read Only: true
    Maximum Length: 30
    The type of the name. It is a value defined by the Additional Party Name and Identifier Type entity. A list of accepted values is defined in the lookup type ORA_HEY_NAME_TYPE.
  • Title: Party ID
    Read Only: true
    The unique identifier for the party. Party can be a person. For example, a student can be a party.
  • Title: Party Name ID
    Read Only: true
    The unique identifier for a name.
  • Phones
    Title: Phones
    The phones resource is a child of search person profiles resource and provides information about the various phone numbers associated with the user.
  • Title: Preferred
    Read Only: true
    Maximum Length: 1
    Indicates the preferred email address.
  • Title: Preferred
    Read Only: true
    Maximum Length: 1
    Indicates the name as preferred name for this party within this name type.
  • Title: Purpose Code
    Read Only: true
    Maximum Length: 30
    The type of purpose for email contact, such as work, emergency, and home. A list of accepted values is defined in the lookup type ORA_HEY_EMAIL_CONTACT_PURPOSE.
  • Student Credentials
    Title: Student Credentials
    The student credentials resource is a child of search person profiles resource and provides a list of credentials awarded to a student.
  • Student Curriculums
    Title: Student Curriculums
    The student curriculum resource is a child of search person profiles resource and provides a list of academic groups and programs associated with a student.
  • Title: Title
    Read Only: true
    Maximum Length: 60
    The title of the person, such as Mr or Mrs.
Nested Schema : Images
Type: array
Title: Images
The images resource is a child of search person profiles resource and provides information about the image uploaded by the user.
Show Source
Nested Schema : Phones
Type: array
Title: Phones
The phones resource is a child of search person profiles resource and provides information about the various phone numbers associated with the user.
Show Source
Nested Schema : Student Credentials
Type: array
Title: Student Credentials
The student credentials resource is a child of search person profiles resource and provides a list of credentials awarded to a student.
Show Source
Nested Schema : Student Curriculums
Type: array
Title: Student Curriculums
The student curriculum resource is a child of search person profiles resource and provides a list of academic groups and programs associated with a student.
Show Source
Nested Schema : searchHedPersonProfiles-images-item-response
Type: object
Show Source
Nested Schema : searchHedPersonProfiles-phones-item-response
Type: object
Show Source
  • Title: Type
    Read Only: true
    Maximum Length: 30
    Default Value: PHONE
    The type code of the contact point.
  • Links
  • Read Only: true
    The object version number of the row.
  • Read Only: true
    The unique identifier of the owner table.
  • Read Only: true
    Maximum Length: 30
    The name of the owner table.
  • Title: Area Code
    Read Only: true
    Maximum Length: 20
    The area code within a country code.
  • Title: Phone Country Code
    Read Only: true
    Maximum Length: 10
    The international country code for a telephone number. For example, 33 for France.
  • Title: Extension
    Read Only: true
    Maximum Length: 20
    The extension number for a phone number.
  • Read Only: true
    The unique identifier for the phone number.
  • Title: Phone
    Read Only: true
    Maximum Length: 40
    The telephone number formatted in the local format. The number should not include area code, country code, or extension.
  • Title: Primary
    Read Only: true
    Maximum Length: 1
    Default Value: false
    Indicates the preferred phone number.
  • Title: Purpose
    Read Only: true
    Maximum Length: 30
    The type of purpose for phone contact, such as work, emergency, and home. A list of accepted values is defined in the lookup type ORA_HEY_PHONE_CONTACT_PURPOSE.
  • Read Only: true
    Maximum Length: 30
    Default Value: A
    Indicates the active phone number.
Nested Schema : searchHedPersonProfiles-studentCredentials-item-response
Type: object
Show Source
  • Read Only: true
    The unique identifier of the academic period that is associated with completion of the enrollment record.
  • Title: Conferral Date
    Read Only: true
    The date when the credential was conferred to the student.
  • Title: Program Credential ID
    Read Only: true
    The unique identifier for the credential associated with the enrollment record.
  • Title: Name
    Read Only: true
    Maximum Length: 50
    The name of the credential associated with the enrollment record.
  • Read Only: true
    The generated primary key column of the credential record.
  • Links
  • Title: Status Code
    Read Only: true
    Maximum Length: 30
    The code of the latest status associated with the credential. Valid values include ORA_AWARDED or ORA_REVOKED. A list of accepted values is defined in the lookup type ORA_HER_CREDENTIAL_STATUS.
  • Title: Status Date
    Read Only: true
    The date of the latest status associated with the credential.
  • Read Only: true
    Maximum Length: 80
    The meaning of the latest status associated with the credential. Valid values include Awarded or Revoked. A list of accepted values is defined in the lookup type ORA_HER_CREDENTIAL_STATUS.
  • Title: Student ID
    Read Only: true
    The unique identifier assigned to a person whose association with an institution is classified as being a student.
Nested Schema : searchHedPersonProfiles-studentCurriculums-item-response
Type: object
Show Source
Nested Schema : Advisors
Type: array
Title: Advisors
The advisors resource is a child of the search person profiles resource and provides a list of advisors assigned to a student.
Show Source
Nested Schema : Student Academic Levels
Type: array
Title: Student Academic Levels
The student academic levels resource is a child of the search person profiles resource and provides a list of academic levels calculated for a student under each reporting period.
Show Source
Nested Schema : Student Academic Loads
Type: array
Title: Student Academic Loads
The student academic loads resource is a child of the search person profiles resource and provides a list of academic loads calculated for a student under each reporting period.
Show Source
Nested Schema : Student Credentials
Type: array
Title: Student Credentials
The student credentials resource is a child of search person profiles resource and provides a list of credentials awarded to a student.
Show Source
Nested Schema : Student Curriculum Elements
Type: array
Title: Student Curriculum Elements
The student curriculum elements resource is a child of the search person profiles resource and provides a list of programs enrolled for a student under an academic group.
Show Source
Nested Schema : searchHedPersonProfiles-studentCurriculums-advisors-item-response
Type: object
Show Source
  • Title: Advisor ID
    Read Only: true
    The generated primary key column of the advisor record.
  • Title: Advisor Name
    Read Only: true
    Maximum Length: 450
    The name of the advisor associated with the enrollment record.
  • Links
  • Title: Primary Advisor
    Read Only: true
    Maximum Length: 1
    Default Value: false
    Identifies the primary advisor associated with the enrollment record.
Nested Schema : searchHedPersonProfiles-studentCurriculums-studentAcademicLevels-item-response
Type: object
Show Source
  • Read Only: true
    The unique identifier for the academic level associated with a student curriculum item. For example, a student program might be associated with the academic level of undergraduate.
  • Read Only: true
    Maximum Length: 50
    The name of the academic level associated with a student curriculum item. For example, a student program might be associated with the academic level of undergraduate.
  • Read Only: true
    Maximum Length: 30
    The student level at the start of an enrollment period.
  • Read Only: true
    Maximum Length: 30
    The unique identifier for the academic level associated with a student curriculum item. For example, a student program might be associated with the academic level of undergraduate.
  • Links
  • Read Only: true
    Maximum Length: 30
    The projected student level at the point of enrollment.
  • Read Only: true
    The date when the reporting period associated with a student enrollment record ended.
  • Read Only: true
    The unique identifier of the reporting period associated with a student enrollment record.
  • Read Only: true
    Maximum Length: 50
    The name of the reporting period associated with a student enrollment record.
  • Read Only: true
    The date when the reporting period associated with a student enrollment record started.
Nested Schema : searchHedPersonProfiles-studentCurriculums-studentAcademicLoads-item-response
Type: object
Show Source
  • Title: Academic Level ID
    Read Only: true
    The unique identifier for the academic level associated with a student curriculum item. For example, a student program might be associated with the academic level of undergraduate.
  • Title: Academic Level Name
    Read Only: true
    Maximum Length: 50
    The name of the academic level associated with a student curriculum item. For example, a student program might be associated with the academic level of undergraduate.
  • Read Only: true
    Maximum Length: 30
    The automatically-calculated academic load of the student, such as full-time or part-time.
  • Links
  • Read Only: true
    Maximum Length: 30
    The manually-assigned student academic load that supersedes the automatically-calculated value.
  • Title: Reporting Period End Date
    Read Only: true
    The date when the reporting period associated with a student enrollment record ended.
  • Title: Reporting Period ID
    Read Only: true
    The unique identifier of the reporting period associated with a student enrollment record.
  • Title: Reporting Period Name
    Read Only: true
    Maximum Length: 50
    The name of the reporting period associated with a student enrollment record.
  • Title: Reporting Period Start Date
    Read Only: true
    The date when the reporting period associated with a student enrollment record started.
Nested Schema : searchHedPersonProfiles-studentCurriculums-studentCredentials-item-response
Type: object
Show Source
  • Read Only: true
    The unique identifier of the academic period that is associated with completion of the enrollment record.
  • Title: Conferral Date
    Read Only: true
    The date when the credential was conferred to the student.
  • Title: Program Credential ID
    Read Only: true
    The unique identifier for the credential associated with the enrollment record.
  • Title: Name
    Read Only: true
    Maximum Length: 50
    The name of the credential associated with the enrollment record.
  • Read Only: true
    The generated primary key column of the credential record.
  • Links
  • Title: Status Code
    Read Only: true
    Maximum Length: 30
    The code of the latest status associated with the credential. Valid values include ORA_AWARDED or ORA_REVOKED. A list of accepted values is defined in the lookup type ORA_HER_CREDENTIAL_STATUS.
  • Title: Status Date
    Read Only: true
    The date of the latest status associated with the credential.
  • Read Only: true
    Maximum Length: 80
    The meaning of the latest status associated with the credential. Valid values include Awarded or Revoked. A list of accepted values is defined in the lookup type ORA_HER_CREDENTIAL_STATUS.
  • Title: Student ID
    Read Only: true
    The unique identifier assigned to a person whose association with an institution is classified as being a student.
Nested Schema : searchHedPersonProfiles-studentCurriculums-studentCurriculumElements-item-response
Type: object
Show Source
Back to Top