Get organization

​

Retrieves a single organization by its ID.

Permissions
Key type Accepted Permission required Notes
Org API key yes org:read Key must be scoped to the org in the URL path
Personal API key yes org:read Caller must have an active membership in the target org; pass X-Org-ID header matching the URL path
Error Codes
Code HTTP Description
authorize.unauthenticated 401 No valid auth credentials
authorize.forbidden 403 Missing org:read permission or wrong org
org.get.org_id.invalid 400 Org ID is malformed or has wrong prefix
org.get.not_found 404 No organization with this ID
org.get.failed 500 Internal query error
Path Parameters
  • id
    Type: string
    required

    Organization ID (e.g. org_01h455vb4pex5vsknk084sn02q)

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/orgs/{id}
curl 'https://api.nametrust.com/orgs/{id}'

{
  "object": "org",
  "id": "org_01h455vb4pex5vsknk084sn02q",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "created_at": "2025-06-01T12:00:00Z",
  "updated_at": "2025-06-15T09:30:00Z"
}

Organization