---
title: "List My Roles"
method: GET
path: "/api/roles"
tags: ["roles"]
---

# List My Roles

`GET /api/roles`

## Request

- Base URL: `https://api.parlel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.parlel.com/api/roles`
- Auth: none declared

Every role this company owns, any status, newest first.

Drafts, open roles and closed ones together, because this is the company's
working list and hiding two thirds of it behind a filter would make "where did
my draft go" the first support question. The board's rules do not apply here:
they are about what strangers may see.

Ordered by ``created_at`` rather than ``published_at``, because a draft has no
``published_at`` and would sort into a null clump at one end -- and the row a
poster is most likely looking for is the one they just made.

Company accounts only. See ``companies.company_account`` for why that is a 403
and a 409 rather than one status.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object[]

## Other responses

- `422`: Validation Error

---

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