---
title: "Get an organization"
method: GET
path: "/v1/orgs/{orgId}"
tags: ["Organizations"]
---

# Get an organization

`GET /v1/orgs/{orgId}`

## Path parameters

- `orgId` string, required

## Response `200`

The organization

- Organization
  - `accountStatus` string — User-facing account state derived from the org's trust & safety risk state. "active" = normal; "restricted" = new deploys paused pending review (existing workloads keep running, funding still allowed); "suspended" = read-only, workloads stopped, pending review; "banned" = disabled. Drives the dashboard account-status banner. Omitted/"active" means no banner.
  - `billingEmail` string, required
  - `createdAt` string
  - `id` string, required
  - `isProvider` boolean
  - `name` string, required
  - `plan` string, required
  - `shortId` string, required
  - `slug` string, required
  - `taxCountry` string — ISO 3166-1 alpha-2 country whose tax scheme taxId belongs to (e.g. US, GB, SG, DE).
  - `taxId` string — Customer tax identifier stored on the organization (US EIN, EU/UK VAT, SG GST, etc.), shown on the billing settings page. Requires taxCountry.

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope
- `404` — Resource not found

## Changes

- **2026-08-21** `6e0f476b5876` — 3 info
  - added the optional property `accountStatus` to the response with the `200` status
  - added the optional property `taxCountry` to the response with the `200` status
  - added the optional property `taxId` to the response with the `200` status

[Change history](https://skmtc.dev/openrelay/apis/openrelay-api/changes/v1/orgs/:orgId/get.md)

---

[API](https://skmtc.dev/openrelay/apis/openrelay-api.md) · [All operations](https://skmtc.dev/openrelay/apis/openrelay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openrelay/openrelay-api/revisions/3dc47c9667e8/schema)