> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gork.email/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization

> Read your organization's profile, quota, sending state, and member list.

Two read-only endpoints expose the organization your API key belongs to. Both require the `organization:read` scope, and both resolve the organization from the key itself — never from request parameters.

<Note>
  Organization mutations (invites, role changes, plan changes) happen in the console, not over REST. Keys carry no user binding, so membership writes would be un-authorizable.
</Note>

## Get organization profile

`GET /v1/organization` returns the current profile plus quota and sending state.

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Organization ID (`org_...`).
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name.
    </ResponseField>

    <ResponseField name="slug" type="string">
      URL-safe identifier.
    </ResponseField>

    <ResponseField name="plan" type="string">
      Billing plan (e.g. `sandbox`, `starter`).
    </ResponseField>

    <ResponseField name="monthlyEmailLimit" type="number">
      Workspace monthly cap. `0` means no workspace cap — the account pool governs.
    </ResponseField>

    <ResponseField name="monthlyEmailsSent" type="number">
      Emails sent this cycle.
    </ResponseField>

    <ResponseField name="storageBytesUsed" type="number">
      Attachment and archive bytes stored.
    </ResponseField>

    <ResponseField name="sendingApproved" type="boolean">
      `false` while sending is paused for review.
    </ResponseField>

    <ResponseField name="overageAllowed" type="boolean">
      Whether metered sending past the allowance is permitted.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 creation timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.gork.email/v1/organization \
    -H "Authorization: Bearer gork_live_YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Gork } from "@gork/sdk"

  const gork = new Gork({ apiKey: process.env.GORK_API_KEY })

  const org = await gork.organization.get()
  ```

  ```python Python theme={null}
  import requests, os

  res = requests.get(
      "https://api.gork.email/v1/organization",
      headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "org_1a2b3c4d",
      "name": "Acme Corp",
      "slug": "acme-corp",
      "plan": "starter",
      "monthlyEmailLimit": 0,
      "monthlyEmailsSent": 312,
      "storageBytesUsed": 1048576,
      "sendingApproved": true,
      "overageAllowed": true,
      "createdAt": "2026-09-01T00:00:00.000Z"
    }
  }
  ```
</ResponseExample>

## List members

`GET /v1/organization/members` returns the human members of the organization — name, email, and role — ordered by join date.

<ResponseField name="data" type="object[]">
  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Membership row ID.
    </ResponseField>

    <ResponseField name="userId" type="string">
      The user's ID.
    </ResponseField>

    <ResponseField name="role" type="string">
      Membership role (e.g. `owner`, `member`).
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name, or `null` when unset.
    </ResponseField>

    <ResponseField name="email" type="string">
      Login email, or `null` when unavailable.
    </ResponseField>

    <ResponseField name="joinedAt" type="string">
      ISO 8601 join timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

```bash cURL theme={null}
curl https://api.gork.email/v1/organization/members \
  -H "Authorization: Bearer gork_live_YOUR_API_KEY"
```

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "mem_1a2b3c4d5e6f",
        "userId": "usr_9f8e7d6c5b4a",
        "role": "owner",
        "name": "Ada Lovelace",
        "email": "ada@acmecorp.com",
        "joinedAt": "2026-09-01T00:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>