The companies you are in

GET

/v1/companies

const url = 'https://beta-api.plune.ai/v1/companies';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://beta-api.plune.ai/v1/companies \
  --header 'Authorization: Bearer <token>'

Every company the caller is in, oldest first, with their role in it and two counts: its projects — all of them, joined or not, since their names are the company’s — and its people. A company in the bin is gone from the list. Somebody in no company gets an empty list.

Authorizations

bearerAuth
cookieAuth

Responses

200

Your companies

application/json

object

companies

required

Array<object>

A company the caller is in, with their role in it and two counts — one row of GET /v1/companies.

object

required

string format: uuid

name

required

string

<= 100 characters

role

required

What a member of a company may do (ADR 0038). owner and admin manage its people and add them to its projects — only an owner makes, unmakes or removes an owner, and only an owner deletes it; member and reader join its projects themselves. A company role opens no project: joining one gives the project role it maps to — owner and admin → owner, member → member, reader → reader.

string

Allowed values: owner admin member reader

projects

required

Its projects — all of them, joined or not: their names are the company’s.

integer

members

required

integer

>= 1

createdAt

required

string format: date-time

Example

{
  "companies": [
    {
      "id": "6f1c2b3a-0000-4000-8000-0000000000a5",
      "name": "Acme",
      "role": "owner",
      "projects": 2,
      "members": 2,
      "createdAt": "2026-09-16T09:12:04.151Z"
    }
  ]
}

401

No / invalid token or session