Retrieve an org

GET/v1/orgs/{id}

Fetches an org by id. Only the credential's active org is accessible.

Requires an API key (bearer), scoped to the active org.

Path parameters

idstringrequired

Returns

200The org.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza orgs get org_3Fy…

GET /v1/orgs/{id}

curl https://api.renza.io/v1/orgs/org_3Fy… \
  -H "Authorization: Bearer $RENZA_API_KEY"

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const org = await renza.orgs.get("org_3Fy…");

Response 200

{
  "id": "org_3Fy…",
  "object": "org",
  "name": "Paul's workspace",
  "type": "personal",
  "metadata": {},
  "created_at": "2026-06-19T10:30:00.000Z",
  "updated_at": "2026-06-19T10:30:00.000Z"
}