Nookhive Logo
StyleguideAPI Reference

Organizations API

Access and manage your organization's settings, branding, and configuration.

Overview

The Organizations API allows you to access and update your organization's settings, including branding, contact information, and billing details.

API keys are scoped to a single organization. You can only access the organization associated with your API key.

Base Path

https://api.nookhive.com/v1/organizations

Endpoints

GET/v1/organizations/me

Get Current Organization

Retrieve details about the organization associated with your API key.

Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/organizations/me" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
ResponseJSON
{
  "organization": {
    "id": "org_abc123",
    "name": "Acme Events Inc",
    "slug": "acme-events",
    "email": "contact@acme-events.com",
    "phone": "+1234567890",
    "website": "https://acme-events.com",
    "timezone": "America/New_York",
    "currency": "USD",
    "logo": "https://files.nookhive.com/orgs/org_abc123/logo.png",
    "address": {
      "line1": "123 Event Street",
      "line2": "Suite 100",
      "city": "New York",
      "state": "NY",
      "postalCode": "10001",
      "country": "US"
    },
    "settings": {
      "invoicePrefix": "INV",
      "requirePayment": true,
      "sendConfirmations": true
    },
    "createdAt": "2025-01-01T00:00:00Z"
  }
}
PUT/v1/organizations/me

Update Organization

Update your organization's settings and configuration.

Parameters

NameTypeDescription
namestringOrganization name
emailstringContact email
phonestringContact phone number
websitestringWebsite URL
timezonestringIANA timezone identifier
currencystringDefault currency (ISO 4217)
addressobjectOrganization address
settingsobjectOrganization settings
Example RequestBASH
curl -X PUT "https://api.nookhive.com/v1/organizations/me" \
  -H "Authorization: Bearer nk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "Asia/Shanghai",
    "settings": {
      "invoicePrefix": "ACME-INV",
      "sendConfirmations": true
    }
  }'
GET/v1/organizations/me/history

Get Organization History

Retrieve audit log entries for your organization. Useful for compliance and tracking changes.

Parameters

NameTypeDescription
pageintegerPage number (default: 1)
limitintegerResults per page (default: 20, max: 100)
actionstringFilter by action type
fromISO 8601Start date for filtering
toISO 8601End date for filtering
Example RequestBASH
curl -X GET "https://api.nookhive.com/v1/organizations/me/history?limit=10" \
  -H "Authorization: Bearer nk_live_your_api_key_here"
ResponseJSON
{
  "history": [
    {
      "id": "audit_xyz789",
      "action": "ORGANIZATION_UPDATED",
      "description": "Organization settings updated",
      "changes": {
        "timezone": {
          "from": "America/New_York",
          "to": "Asia/Shanghai"
        }
      },
      "performedBy": "user_abc123",
      "performedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}

The Organization Object

{
  "id": "org_abc123",
  "name": "Acme Events Inc",
  "slug": "acme-events",
  "email": "contact@acme-events.com",
  "phone": "+1234567890",
  "website": "https://acme-events.com",
  "timezone": "America/New_York",
  "currency": "USD",
  "locale": "en-US",
  "logo": "https://files.nookhive.com/orgs/org_abc123/logo.png",
  "favicon": "https://files.nookhive.com/orgs/org_abc123/favicon.ico",
  "primaryColor": "#0066cc",
  "address": {
    "line1": "123 Event Street",
    "line2": "Suite 100",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "billing": {
    "taxId": "XX-XXXXXXX",
    "bankAccount": "****1234"
  },
  "settings": {
    "invoicePrefix": "INV",
    "requirePayment": true,
    "sendConfirmations": true,
    "allowWaitlist": true,
    "maxBookingsPerUser": 10
  },
  "plan": "PROFESSIONAL",
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2026-01-15T10:00:00Z"
}