---
title: "Team access: List bases shared with this organization."
method: GET
path: "/api/teams/{organization_id}/bases"
---

# Team access: List bases shared with this organization.

`GET /api/teams/{organization_id}/bases`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/teams/{organization_id}/bases`
- Auth: none declared

Team access uses current account membership, product access and resource sharing on every request. Revocation also blocks search, originals, Markdown, OKF and ZIP downloads with an existing session or key. Sharing a collection grants current and future files in its owner's referenced bases; other owners' bases expose published files only. Sharing does not publish a resource. Only the resource owner changes sharing. The initial grant requires the owner's session with origin and CSRF checks. Organization API keys stay within their existing grants. Responses use private, no-store.
Returns: { items[{id,name,visibility,dataset,created_at,updated_at,documents,bytes,api,export_url,okf_url,public_url,embed_url,publication}], next, read_only }

## Path parameters

- `organization_id` string, required

## Query parameters

- `after` string

## Response `200`

{ items[{id,name,visibility,dataset,created_at,updated_at,documents,bytes,api,export_url,okf_url,public_url,embed_url,publication}], next, read_only }

- object
  - `items` Base[], required: At most 20 directly shared resources, ordered by ID.
    - `id` string, required: The 64-character ID returned by the API.
    - `name` string, required: Base name.
    - `visibility` string, required: private or public; only explicit publication makes a base public.
    - `dataset` Dataset, required
      - `description` string, required: Dataset description, 1–2000 characters.
      - `fields` DatasetField[], required: 1–30 fields, each with a name and description.
        - `name` string, required: Field name, 1–80 characters.
        - `description` string, required: Meaning, 1–200 characters.
      - `coverage` string, required: Geographic, temporal or subject coverage, 1–300 characters.
      - `format` string, required: Source format, for example CSV or JSON, 1–40 characters.
      - `update_frequency` string, required: Declared update schedule, 1–200 characters. No automatic check is performed.
      - `license` string, required: Declared license or access terms, 1–300 characters. Not independently verified.
      - `source_url` string, required: HTTPS origin URL, at most 1000 characters, without credentials.
    - `created_at` string, required: Creation date, ISO 8601.
    - `updated_at` string, required: Last change, ISO 8601.
    - `documents` integer, nullable, required: Document count when returned by the base list; null otherwise.
    - `bytes` integer, nullable, required: Current original bytes in the owner's base list; null in other private responses. Omitted from public responses.
    - `api` string, required: Metadata URL.
    - `export_url` string, required: ZIP download URL.
    - `okf_url` string, required: OKF root index URL.
    - `public_url` string, nullable, required: Public page URL while published; null when private.
    - `embed_url` string, nullable, required: Public search iframe URL while published; null when private. Uses the same public API and limits. No account controls inside the iframe.
    - `publication` BasePublication, required
      - `author` string, required: Author or attribution declared by the publisher.
      - `source_url` string, nullable, required: Declared HTTPS source, or null for uploaded files.
      - `terms` string, required: Terms declared by the publisher. This is not an independent license verification.
      - `published_at` string, required: Date of the last explicit publication, ISO 8601.
  - `next` string, nullable, required: Next page URL, or null.
  - `read_only` boolean, required: Always true. Only the personal owner can edit files or collection references.

## Other responses

- `400`: Invalid query or cursor.
- `401`: A valid session or organization API key is required.
- `403`: Organization access requires the correct credential and, when applicable, MFA.
- `404`: The organization, resource or sharing grant is inaccessible.
- `405`: Team access is read-only.
- `409`: A file is not ready for export.
- `503`: Account or knowledge storage is unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)