---
title: "List role assignments in the actor's organization."
method: GET
path: "/v1/role_assignments"
tags: ["Roles"]
---

# List role assignments in the actor's organization.

`GET /v1/role_assignments`

## Request

- Base URL: `https://api.yardstick.team`
- URL: `https://api.yardstick.team/v1/role_assignments`
- Auth: HTTP bearer

## Query parameters

- `user_id` string
- `role` 'admin' | 'recruiter' | 'department_lead' | 'hiring_manager'
- `cursor` string
- `limit` integer

## Response `200`

Paginated role assignments.

- RoleAssignmentList
  - `data` RoleAssignment[], required
    - `id` string, required
    - `user` string, required
    - `role` 'admin' | 'recruiter' | 'department_lead' | 'hiring_manager', required
    - `scope` union, required
      - object
        - `type` 'org', required
        - `id` string, required
      - object
        - `type` 'department', required
        - `id` string, required
      - object
        - `type` 'job', required
        - `id` string, required
    - `created_at` string, date-time, required
    - `created_by` string, nullable
  - `next_cursor` string

## Other responses

- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `422` (unresolved $ref)

---

[API](https://skmtc.dev/yardstick/apis/yardstick-public-api.md) · [All operations](https://skmtc.dev/yardstick/apis/yardstick-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yardstick/apis/yardstick-public-api/revisions/35b5a6e88b35?raw)