--- id: get-non-employee-request sidebar_label: Get a Non-Employee Request hide_title: true hide_table_of_contents: true api: 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 sidebar_class_name: "get api-method" info_path: docs/api/v3/identitynow-v-3-api custom_edit_url: "https://github.com/sailpoint-oss/developer.sailpoint.com/issues/new?assignees=&labels=&template=bug-report.md&title=%5BBug%5D+Your+Bug+Report+Here Requesting changes to 'Get a Non-Employee Request' (get-non-employee-request)" --- import ApiTabs from "@theme/ApiTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes"; import MimeTabs from "@theme/MimeTabs"; import ParamsItem from "@theme/ParamsItem"; import ResponseSamples from "@theme/ResponseSamples"; import SchemaItem from "@theme/SchemaItem"; import SchemaTabs from "@theme/SchemaTabs"; import TabItem from "@theme/TabItem";

Get a Non-Employee Request

This gets a non-employee request. There are two contextual uses for this endpoint: 1. The user has the role context of `idn:nesr:read`, in this case the user can get the non-employee request for any user. 2. The user must be the owner of the non-employee request. ## Request

Path Parameters

Non-Employee request object.
Schema
    nonEmployeeSource object
    data object
    Attribute blob/bag for a non-employee.
    approvalItems object[]
    List of approval item for the request
  • Array [
  • approver object
    Reference to the associated Identity
  • ]
Client Error - Returned if the request body is invalid.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Schema
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 403 response object

Not Found - returned if the request URL refers to a resource or object that does not exist
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 404 response object

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Schema
Internal Server Error - Returned if there is an unexpected error.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 500 response object