Organization

curl https://api.gork.email/v1/organization \
  -H "Authorization: Bearer gork_live_YOUR_API_KEY"

import { Gork } from "@gork/sdk"

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

const org = await gork.organization.get()

import requests, os

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

{
  "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"
  }
}

curl https://api.gork.email/v1/organization \
  -H "Authorization: Bearer gork_live_YOUR_API_KEY"

import { Gork } from "@gork/sdk"

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

const org = await gork.organization.get()

import requests, os

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

{
  "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"
  }
}

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.

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.

Get organization profile

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

object

Show properties

string

Organization ID (org_...).

string

Display name.

string

URL-safe identifier.

string

Billing plan (e.g. sandbox, starter).

number

Workspace monthly cap. 0 means no workspace cap — the account pool governs.

number

Emails sent this cycle.

number

Attachment and archive bytes stored.

boolean

false while sending is paused for review.

boolean

Whether metered sending past the allowance is permitted.

string

ISO 8601 creation timestamp.

curl https://api.gork.email/v1/organization \
  -H "Authorization: Bearer gork_live_YOUR_API_KEY"

import { Gork } from "@gork/sdk"

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

const org = await gork.organization.get()

import requests, os

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

{
  "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"
  }
}

List members

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

object[]

Show properties

string

Membership row ID.

string

The user’s ID.

string

Membership role (e.g. owner, member).

string

Display name, or null when unset.

string

ISO 8601 join timestamp.

cURL

curl https://api.gork.email/v1/organization/members \
  -H "Authorization: Bearer gork_live_YOUR_API_KEY"

{
  "data": [
    {
      "id": "mem_1a2b3c4d5e6f",
      "userId": "usr_9f8e7d6c5b4a",
      "role": "owner",
      "name": "Ada Lovelace",
      "email": "ada@acmecorp.com",
      "joinedAt": "2026-09-01T00:00:00.000Z"
    }
  ]
}

Overview

Endpoints

Organization

Get organization profile

List members

​Get organization profile

​List members

Get organization profile

List members