---
title: "Get Organization"
method: GET
path: "/v0/organizations"
tags: ["Organizations"]
---

# Get Organization

`GET /v0/organizations`

Returns the organization for the authenticated API key (usage limits, counts, and billing metadata).

**CLI:**
```bash
agentmail organizations get
```

## Response `200`

- Organization — Organization details with usage limits and counts.
  - `organization_id` string, required — ID of organization.
  - `inbox_count` integer, required — Current number of inboxes.
  - `domain_count` integer, required — Current number of domains.
  - `inbox_limit` integer, nullable — Maximum number of inboxes allowed.
  - `domain_limit` integer, nullable — Maximum number of domains allowed.
  - `billing_id` string, nullable — Provider-agnostic billing customer ID.
  - `billing_type` string, nullable — Billing provider type (e.g. "stripe").
  - `billing_subscription_id` string, nullable — Active billing subscription ID.
  - `authentication_id` string, nullable — Provider-agnostic authentication ID.
  - `authentication_type` string, nullable — Authentication provider type.
  - `updated_at` string, date-time, required — Time at which organization was last updated.
  - `created_at` string, date-time, required — Time at which organization was created.

## Changes

- **2026-03-31** `27965096e618` — 5 info
  - added the optional property `authentication_id` to the response with the `200` status
  - added the optional property `authentication_type` to the response with the `200` status
  - added the optional property `billing_id` to the response with the `200` status
  - added the optional property `billing_subscription_id` to the response with the `200` status
  - …1 more
- **2026-03-28** `8a5b5e92ae2d` — 5 warning
  - removed the optional property `authentication_id` from the response with the `200` status
  - removed the optional property `authentication_type` from the response with the `200` status
  - removed the optional property `billing_id` from the response with the `200` status
  - removed the optional property `billing_subscription_id` from the response with the `200` status
  - …1 more
- **2026-03-05** `7557de0221c9` — 5 info
  - added the optional property `authentication_id` to the response with the `200` status
  - added the optional property `authentication_type` to the response with the `200` status
  - added the optional property `billing_id` to the response with the `200` status
  - added the optional property `billing_subscription_id` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/organizations/get.md)

---

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