---
title: "List users for report sharing"
method: POST
path: "/api/users/for-report-sharing"
tags: ["User Management"]
---

# List users for report sharing

`POST /api/users/for-report-sharing`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/users/for-report-sharing`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/users/for-report-sharing/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of users filtered by role orientation, job role, user role, organization, organization type, product, account manager, representative, league, subcategory, genre, subgenre, category, user name, job title, last activity dates, and report received/opened counts and dates. Used to select recipients when sharing custom reports.

## Request body

- UserForReportSharingRequest
  - `role_orientation` unknown
  - `user_job_role` unknown
  - `user_role` unknown
  - `organization` unknown
  - `organization_type` unknown
  - `organization_product` unknown
  - `organization_account_manager` unknown
  - `representative` unknown
  - `league` unknown
  - `subcategory` unknown
  - `genre` unknown
  - `subgenre` unknown
  - `category` unknown
  - `user_name` string: Search by user name (partial match).
  - `job_title` string: Search by job title (partial match).
  - `last_activity_from` string, date-time: Filter by last activity on or after this date.
  - `last_activity_to` string, date-time: Filter by last activity on or before this date.
  - `reports_received_min` integer: Filter by minimum number of reports received.
  - `last_received_date_from` string, date-time: Filter by last received report date on or after this date.
  - `last_received_date_to` string, date-time: Filter by last received report date on or before this date.
  - `reports_opened_min` integer: Filter by minimum number of reports opened.
  - `last_opened_date_from` string, date-time: Filter by last opened report date on or after this date.
  - `last_opened_date_to` string, date-time: Filter by last opened report date on or before this date.
  - `page` integer: Page number for pagination
  - `per_page` integer: Items per page (max 1000)

## Response `200`

Paginated list of users for report sharing

- object
  - `data` UserForReportSharingResource[]
    - `id` integer: API resource for a user in the report-sharing selection list.
    - `userName` string
    - `email` string, nullable
    - `jobTitle` string, nullable
    - `roleOrientation` string, nullable
    - `userJobRole` string, nullable
    - `userRole` string, nullable
    - `organization` string, nullable
    - `organizationType` string, nullable
    - `organizationProduct` string, nullable
    - `organizationAccountManager` string, nullable
    - `representatives` string, nullable
    - `representativesFull` string[]
    - `representativesCount` integer
    - `leagueAndPlatform` string, nullable
    - `leaguesFull` string[]
    - `leaguesCount` integer
    - `subcategory` string, nullable
    - `subcategoriesFull` string[]
    - `subcategoriesCount` integer
    - `genre` string, nullable
    - `subgenre` string, nullable
    - `category` string, nullable
    - `lastActivity` string, date-time, nullable
    - `reportsReceived` integer
    - `lastReceivedDate` string, date-time, nullable
    - `reportsOpened` integer
    - `lastOpenedDate` string, date-time, nullable
  - `current_page` integer
  - `last_page` integer
  - `per_page` integer
  - `total` integer

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden - Not authorized to view users
- `422`: Validation error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)