---
title: "Get Organization"
method: GET
path: "/api/organization/{organization_id}"
tags: ["Organization"]
---

# Get Organization

`GET /api/organization/{organization_id}`

Fetch the details of an organization by its id. Auth'ed user or api key must have an admin or owner role for the specified dataset's organization.

## Path parameters

- `organization_id` string, uuid, required

## Headers

- `TR-Organization` string, uuid, required

## Response `200`

Organization with the id that was requested

- OrganizationWithSubAndPlan
  - `organization` Organization, required
    - `created_at` string, date-time, required — Timestamp of the creation of the dataset
    - `deleted` integer, required — Flag to indicate if the organization has been deleted. Deletes are handled async after the flag is set so as to avoid expensive search index compaction.
    - `id` string, uuid, required — Unique identifier of the dataset, auto-generated uuid created by Trieve
    - `name` string, required — Name of the organization
    - `partner_configuration` unknown, required
    - `registerable` boolean, nullable — Flag to indicate whether or not new users may join the organization. Default is true.
    - `updated_at` string, date-time, required — Timestamp of the last update of the dataset
  - `plan` union
    - object
      - `amount` integer, required
      - `chunk_count` integer, required
      - `created_at` string, date-time, required
      - `dataset_count` integer, required
      - `file_storage` integer, required
      - `id` string, uuid, required
      - `message_count` integer, required
      - `messages_per_month` integer, nullable
      - `name` string, required
      - `stripe_id` string, required
      - `updated_at` string, date-time, required
      - `user_count` integer, required
      - `visible` boolean, required
      - `type` 'flat', required
    - object
      - `analytics_events_price_id` string, required
      - `bytes_ingested_price_id` string, required
      - `chunks_stored_price_id` string, required
      - `created_at` string, date-time, required
      - `datasets_price_id` string, required
      - `files_storage_price_id` string, required
      - `id` string, uuid, required
      - `ingest_tokens_price_id` string, required
      - `message_tokens_price_id` string, required
      - `name` string, required
      - `ocr_pages_price_id` string, required
      - `pages_crawls_price_id` string, required
      - `platform_price_amount` integer, nullable
      - `platform_price_id` string, nullable
      - `search_tokens_price_id` string, required
      - `users_price_id` string, required
      - `visible` boolean, required
      - `type` 'usage_based', required
  - `subscription` union
    - object
      - `created_at` string, date-time, required
      - `current_period_end` string, date-time, nullable
      - `id` string, uuid, required
      - `organization_id` string, uuid, required
      - `plan_id` string, uuid, required
      - `stripe_id` string, required
      - `updated_at` string, date-time, required
      - `type` 'flat', required
    - object
      - `created_at` string, date-time, required
      - `current_period_end` string, date-time, nullable
      - `id` string, uuid, required
      - `last_cycle_chunks_stored_mb` integer, required
      - `last_cycle_dataset_count` integer, required
      - `last_cycle_files_storage_mb` integer, required
      - `last_cycle_timestamp` string, date-time, required
      - `last_cycle_users_count` integer, required
      - `last_recorded_meter` string, date-time, required
      - `organization_id` string, uuid, required
      - `stripe_subscription_id` string, required
      - `usage_based_plan_id` string, uuid, required
      - `type` 'usage_based', required

## Other responses

- `400` — Service error relating to finding the organization by id
- `404` — Organization not found

---

[API](https://skmtc.net/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.net/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/revisions/84583e7c9fc1/schema)