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
| Field | Type | Description |
|---|---|---|
organization_idrequired | string | Must equal the credential's own organization id. |
Response 200
The organization.
Fields
| Field | Type | Description |
|---|---|---|
idrequired | string | Stable opaque organization id.e.g. 9f6acab2-8f8e-4c7e-9c3a-2f6d0c9e4b11 |
namerequired | string | Display name.e.g. Acme Inc |
slugrequired | string | URL-safe unique slug.e.g. acme-inc |
image_urlrequired | string | null | Logo URL, or null when none is set. |
created_atrequired | string (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
- 401
missing_credentialsMissing credentials - 401
invalid_api_keyInvalid API key - 401
invalid_tokenInvalid access token - 403
insufficient_scopeInsufficient scope - 403
feature_not_enabledFeature not enabled on this plan - 404
resource_not_foundResource not found - 429
rate_limitedRate limit exceeded - 429
quota_exhaustedPlan quota exhausted - 500
internal_errorInternal server error