---
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; "pending" = a verification hold: the account can sign in and use the dashboard but cannot be funded, new deploys are paused, existing workloads keep running, and it clears on review (usually under one business day); "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.
  - `billingAddressLine1` string
  - `billingAddressLine2` string
  - `billingCity` string
  - `billingCountry` string — ISO 3166-1 alpha-2 country of the billing address.
  - `billingEmail` string, required
  - `billingName` string — Name printed on invoices and credit notes. Empty means the org name is used.
  - `billingPostalCode` string
  - `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-09-23** `623ef854267a` — 6 info
  - added the optional property `billingAddressLine1` to the response with the `200` status
  - added the optional property `billingAddressLine2` to the response with the `200` status
  - added the optional property `billingCity` to the response with the `200` status
  - added the optional property `billingCountry` to the response with the `200` status
  - …2 more
- **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.dev/openrelay/apis/openrelay-api/revisions/24a11ebdab5e?raw)