get:
  tags:
    - Source Usages
  summary: Returns source usage insights
  description: >-
    This API returns a summary of source usage insights for past 12 months.
  operationId: getUsagesBySourceId
  parameters:
    - name: sourceId
      in: path
      description: ID of IDN source
      required: true
      schema:
        type: string
      example: '2c9180835d191a86015d28455b4a2329'
    - $ref: '../../v3/parameters/limit.yaml'
    - $ref: '../../v3/parameters/offset.yaml'
    - $ref: '../../v3/parameters/count.yaml'
    - in: query
      name: sorters
      schema:
        type: string
        format: comma-separated
      description: >-
        Sort results using the standard syntax described in [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters#sorting-results)


        Sorting is supported for the following fields: **date**
      example: -date
  security:
    - UserContextAuth: [ idn:accounts:read ]
  responses:
    '200':
      description: Summary of source usage insights for past 12 months.
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '../schemas/SourceUsage.yaml'
    '400':
      $ref: '../../v3/responses/400.yaml'
    '401':
      $ref: '../../v3/responses/401.yaml'
    '403':
      $ref: '../../v3/responses/403.yaml'
    '429':
      $ref: '../../v3/responses/429.yaml'
    '500':
      $ref: '../../v3/responses/500.yaml'