---
title: "Get the current organization."
method: GET
path: "/v1/org"
tags: ["org"]
---

# Get the current organization.

`GET /v1/org`

## Request

- Base URL: `https://api.smolmachines.com`
- URL: `https://api.smolmachines.com/v1/org`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/smolmachines/apis/smolfleet-api/docs/v1/org/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the organization the request acts in, with its machine counts. Any valid credential for that organization.

## Response `200`

The organization context of the account the request acts in, with how many machines it has and runs; the tenant id, slug and display name are null and the counts absent for an individual account.

- OrgSummary: Summary of the caller's org context driving the console's member UI.
  - `canManageMembers` boolean, required: True when the caller may invite/change-role/remove members (owner/admin).
  - `displayName` string, nullable: The display name the owner may rename; null when the account is not an organization.
  - `isOrganization` boolean, required: True when the account is an organization (vs an individual login).
  - `name` string, nullable: The slug, unique and final once chosen; null when the account is not an organization.
  - `quota` OrgQuota: An organization's limits and usage, counted once across every member's machines.
    - `machines` integer, required: How many machines it has now, by the same count the refusal reports.
    - `running` integer, required: How many are running now, by the concurrency cap's own predicate.
  - `tenantId` string, nullable: The org's tenant id for `Smol-Tenant`; null when the account is not an organization.

## Other responses

- `401`: Missing or invalid API key
- `403`: Key lacks the required scope
- `429`: Rate limited; retry after the Retry-After header
- `500`: Internal error

## Changes

- **2026-10-16** `bc31fc04a568`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smolmachines/apis/smolfleet-api/changes/v1/org/get.md)

---

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