> ## 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.

# Get Inbox

> Fetch a single inbox by ID, scoped to your organization.

Returns the full record for one inbox in your organization.

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token formatted as `Bearer gork_live_...`. Requires the `inboxes:read` scope.
</ParamField>

### Path parameters

<ParamField body="id" type="string" required>
  The inbox ID (`inb_...`).
</ParamField>

<Note>
  Inbox-bound agent keys may only fetch their own inbox — any other ID returns `403 inbox_access_denied`.
</Note>

### Response

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

    <ResponseField name="organizationId" type="string">
      The organization that owns this inbox.
    </ResponseField>

    <ResponseField name="agentId" type="string">
      Linked agent ID, or `null` when unassigned.
    </ResponseField>

    <ResponseField name="address" type="string">
      Full email address (e.g. `support@try.gork.email`).
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name for the inbox.
    </ResponseField>

    <ResponseField name="isActive" type="boolean">
      `false` once the inbox has been deactivated.
    </ResponseField>

    <ResponseField name="deletedAt" type="string">
      Deactivation timestamp, or `null` for active inboxes.
    </ResponseField>

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

    <ResponseField name="updatedAt" type="string">
      ISO 8601 last-update timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.gork.email/v1/inboxes/inb_728af980b4e \
    -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 inbox = await gork.inboxes.get("inb_728af980b4e")
  ```

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

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

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "inb_728af980b4e",
      "organizationId": "org_1a2b3c4d",
      "agentId": null,
      "address": "support@try.gork.email",
      "name": "support",
      "isActive": true,
      "deletedAt": null,
      "createdAt": "2026-09-07T12:00:00.000Z",
      "updatedAt": "2026-09-07T12:00:00.000Z"
    }
  }
  ```
</ResponseExample>

| Code                  | HTTP | Meaning                                                         |
| --------------------- | ---- | --------------------------------------------------------------- |
| `inbox_access_denied` | 403  | The key is bound to a different inbox and cannot read this one. |
| `inbox_not_found`     | 404  | No inbox with this ID exists in your organization.              |