---
title: "Get namespace"
method: GET
path: "/v1/organizations/{organizationRef}/namespaces/{namespaceRef}"
tags: ["Namespace"]
---

# Get namespace

`GET /v1/organizations/{organizationRef}/namespaces/{namespaceRef}`

Return the namespace identified by xid or slug under the organization. Lookup uses the same reachability as listing accessible namespaces so descendant-only users can open deep links. organization.read is not required.

## Response `200`

OK

- AccessibleNamespace — A reachable namespace with its owning organization stub.
  - `id` string, required — Unique identifier of the namespace.
  - `slug` string, required — Organization-scoped canonical kebab-case slug.
  - `name` string, required — Name of the namespace.
  - `description` string, nullable — Description of the namespace.
  - `project_count` integer, nullable — Number of projects in the namespace when projected.
  - `document_count` integer, nullable — Number of documents in the namespace when projected.
  - `created_at` string, date-time, required — Date when the namespace was created.
  - `updated_at` string, date-time, nullable, required — Date when the namespace was updated.
  - `organization` PartialOrganization, required — Owning organization stub returned with a reachable namespace.
    - `id` string, required — Unique identifier of the organization.
    - `slug` string, required — Globally unique canonical kebab-case slug.
    - `name` string, required — Name of the organization.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `404` — The requested resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.dev/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opcotech/elemo-api/revisions/836ecb425096/schema)
