Get It Done Logo
Get It Done

Get an organization

GET/v1/organizations/{organization_id}

Fetches a single organization by id. The id MUST equal this credential's own organization — any other id (including one that genuinely exists for a different tenant) answers 404 `resource_not_found`; there is no cross-org existence oracle.

Required scopes
workspaces:read
Availability
All plans
Quota cost
1 API call
Idempotency
Not applicable

Request

Path parameters

FieldTypeDescription
organization_idrequiredstringMust equal the credential's own organization id.

Response 200

The organization.

Fields

FieldTypeDescription
idrequiredstringStable opaque organization id.e.g. 9f6acab2-8f8e-4c7e-9c3a-2f6d0c9e4b11
namerequiredstringDisplay name.e.g. Acme Inc
slugrequiredstringURL-safe unique slug.e.g. acme-inc
image_urlrequiredstring | nullLogo URL, or null when none is set.
created_atrequiredstring (date-time)Creation time, ISO-8601 UTC.e.g. 2026-01-15T09:30:00.000Z
Raw response schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable opaque organization id.",
      "example": "9f6acab2-8f8e-4c7e-9c3a-2f6d0c9e4b11"
    },
    "name": {
      "type": "string",
      "description": "Display name.",
      "example": "Acme Inc"
    },
    "slug": {
      "type": "string",
      "description": "URL-safe unique slug.",
      "example": "acme-inc"
    },
    "image_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Logo URL, or null when none is set."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "Creation time, ISO-8601 UTC.",
      "example": "2026-01-15T09:30:00.000Z"
    }
  },
  "required": [
    "id",
    "name",
    "slug",
    "image_url",
    "created_at"
  ],
  "additionalProperties": false,
  "description": "An organization (workspace) — the tenant every task, project and API credential belongs to."
}

Example request

curl
curl -X GET https://app.nowgetitdone.com/v1/organizations/org_a1b2c3 \
  -H "Authorization: Bearer gid_YOUR_API_KEY"

Possible errors