Get a person profile

get

/fscmRestApi/resources/11.13.18.05/searchHedPersonProfiles/{PartyId}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
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
  • 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-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 HZ_GENDER.
  • Read Only: true
    Maximum Length: 80
    The meaning of the gender code. A list of accepted values is defined in the lookup type HZ_GENDER.
  • Images
    Title: Images
    The images resource 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's 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 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 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 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 phone 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 phone 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's 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 student curriculum 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 student curriculum 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 student curriculum 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's 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