---
title: "Fetch the calling credential's organization"
method: GET
path: "/orgs/{id}"
tags: ["Account"]
---

# Fetch the calling credential's organization

`GET /orgs/{id}`

## Request

- Base URL: `https://thesignup.app/api/v1`
- URL: `https://thesignup.app/api/v1/orgs/{id}`
- Auth: HTTP bearer

Returns 404 for any organization other than the caller's. Useful when an agent needs the org's tier or slug without re-parsing the /v1/me response.

## Path parameters

- `id` string, required

## Response `200`

Organization details

- Organization
  - `id` string, required
  - `name` string, required
  - `slug` string, required
  - `tier` 'free' | 'pro' | 'org' | 'enterprise', required: The tier the org is *entitled to right now* — what rate limits and feature gating will actually enforce. Not necessarily the plan last paid for: a canceled subscription reports the paid tier until its period ends and `free` after, and a support grant reports the granted tier. Build against this value.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `401`: Unauthenticated — credentials missing, malformed, invalid, or revoked
- `404`: Not found
- `429`: Rate limited or daily ceiling exceeded
- `500`: Internal server error

---

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