Skip to main content

Get a Non-Employee Request

GET 

https://sailpoint.api.identitynow.com/v2024/non-employee-requests/:id

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

    id stringrequired

    Non-Employee request id (UUID)

    Example: ac110005-7156-1150-8171-5b292e3e0084

Responses

Non-Employee request object.

Schema
    idUUID

    Non-Employee source id.

    Example: a0303682-5e4a-44f7-bdc2-6ce6112549c1
    sourceIdstring

    Source Id associated with this non-employee source.

    Example: 2c91808568c529c60168cca6f90c1313
    namestring

    Source name associated with this non-employee source.

    Example: Retail
    descriptionstring

    Source description associated with this non-employee source.

    Example: Source description
    accountNamestring

    Requested identity account name.

    Example: william.smith
    firstNamestring

    Non-Employee's first name.

    Example: William
    lastNamestring

    Non-Employee's last name.

    Example: Smith
    emailstring

    Non-Employee's email.

    Example: william.smith@example.com
    phonestring

    Non-Employee's phone.

    Example: 5125555555
    managerstring

    The account ID of a valid identity to serve as this non-employee's manager.

    Example: jane.doe
    nonEmployeeSource object
    idUUID

    Non-Employee source id.

    Example: a0303682-5e4a-44f7-bdc2-6ce6112549c1
    sourceIdstring

    Source Id associated with this non-employee source.

    Example: 2c91808568c529c60168cca6f90c1313
    namestring

    Source name associated with this non-employee source.

    Example: Retail
    descriptionstring

    Source description associated with this non-employee source.

    Example: Source description
    data object

    Additional attributes for a non-employee. Up to 10 custom attributes can be added.

    property name*string
    approvalItems object[]

    List of approval item for the request

  • Array [
  • idUUID

    Non-Employee approval item id

    Example: 2c1e388b-1e55-4b0a-ab5c-897f1204159c
    approver object

    Reference to the associated Identity

    typestring

    Identifies if the identity is a normal identity or a governance group

    Possible values: [GOVERNANCE_GROUP, IDENTITY]

    Example: IDENTITY
    idstring

    Identity id

    Example: 5168015d32f890ca15812c9180835d2e
    accountNamestring

    Requested identity account name

    Example: test.account
    approvalStatusstring

    Enum representing the non-employee request approval status

    Possible values: [APPROVED, REJECTED, PENDING, NOT_READY, CANCELLED]

    Example: APPROVED
    approvalOrderfloat

    Approval order

    Example: 1
    commentstring

    comment of approver

    Example: I approve
    modifieddate-time

    When the request was last modified.

    Example: 2019-08-23T18:52:59.162Z
    createddate-time

    When the request was created.

    Example: 2019-08-23T18:40:35.772Z
  • ]
  • approvalStatusstring

    Enum representing the non-employee request approval status

    Possible values: [APPROVED, REJECTED, PENDING, NOT_READY, CANCELLED]

    Example: APPROVED
    commentstring

    Comment of requester

    Example: approved
    completionDatedate-time

    When the request was completely approved.

    Example: 2020-03-24T11:11:41.139-05:00
    startDatedate-time

    Non-Employee employment start date.

    Example: 2020-03-24T00:00:00-05:00
    endDatedate-time

    Non-Employee employment end date.

    Example: 2021-03-25T00:00:00-05:00
    modifieddate-time

    When the request was last modified.

    Example: 2020-03-24T11:11:41.139-05:00
    createddate-time

    When the request was created.

    Example: 2020-03-24T11:11:41.139-05:00

Authorization: oauth2

package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://sailpoint.api.identitynow.com/v2024/non-employee-requests/:id"
method := "GET"

client := &http.Client {
}
req, err := http.NewRequest(method, url, nil)

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Accept", "application/json")
req.Header.Add("Authorization", "Bearer <TOKEN>")

res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()

body, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v2024
Auth
Parameters
— pathrequired
ResponseClear

Click the Send API Request button above and see the response here!