get:
  tags:
    - Reports Data Extraction
  description: >-
    Gets a report in file format.
  operationId: getReport
  summary: "Get Report File"
  security:
    - oauth2: [sp:report:read]
  parameters:
    - in: path
      name: taskResultId
      schema:
        type: string
      required: true
      description: Unique identifier of the task result which handled report
      example: ef38f94347e94562b5bb8424a56397d8
    - in: path
      name: fileFormat
      schema:
        type: string
      required: true
      description: Output format of the requested report file
      example: 'CSV'
    - in: query
      name: name
      required: false
      schema:
        type: string
      example: 'Identities Details Report'
      description: preferred Report file name, by default will be used report name from task result.
  responses:
    '200':
      description: Details about running report task.
      content:
        application/octet-stream:
          schema:
            type: string
            format: binary
      headers:
        Content-disposition:
          description: The requested report's filename
          schema:
            type: string
          example: 'attachment;filename=\"fileName"'
    '400':
      $ref: '../../v3/responses/400.yaml'
    '401':
      $ref: '../../v3/responses/401.yaml'
    '403':
      $ref: '../../v3/responses/403.yaml'
    '404':
      description: Not Found - returned if the request URL refers to a resource or object that does not exist
      content:
        application/json:
          schema:
            $ref: '../../v3/schemas/ErrorResponseDto.yaml'
          examples:
            "404":
              summary: An example of a 404 response object
              value:
                detailCode: "404 Not found"
                trackingId: "b21b1f7ce4da4d639f2c62a57171b427"
                messages:
                  - locale: "en-US"
                    localeOrigin: "DEFAULT"
                    text: "<h1>File Not Found - 404 Error</h1> The requested file was not found."
    '429':
      $ref: '../../v3/responses/429.yaml'
    '500':
      $ref: '../../v3/responses/500.yaml'
