Skip to main content

Returns source usage insights

GET 

https://sailpoint.api.identitynow.com/v2025/source-usages/:sourceId/summaries

This API returns a summary of source usage insights for past 12 months.

Request

Path Parameters

    sourceId stringrequired

    ID of IDN source

    Example: 2c9180835d191a86015d28455b4a2329

Query Parameters

    limit int32

    Possible values: <= 250

    Max number of results to return. See V3 API Standard Collection Parameters for more information.

    Default value: 250
    Example: 250
    offset int32

    Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.

    Default value: 0
    Example: 0
    count boolean

    If true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored.

    Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used.

    See V3 API Standard Collection Parameters for more information.

    Default value: false
    Example: true
    sorters comma-separated

    Sort results using the standard syntax described in V3 API Standard Collection Parameters

    Sorting is supported for the following fields: date

    Example: -date

Responses

Summary of source usage insights for past 12 months.

Schema
  • Array [
  • datedate

    The first day of the month for which activity is aggregated.

    Example: 2023-04-21
    countfloat

    The average number of days that accounts were active within this source, for the month.

    Example: 10.45
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: idn:accounts:read
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2025/source-usages/:sourceId/summaries"
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/v2025
Auth
Parameters
— pathrequired
— query
— query
— query
— query
ResponseClear

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