> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dittowords.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are Ditto's developer docs. Ditto is a single source of truth for product copy across design, review, localization, and code.
> The first step on any codebase is a scan: https://developer.dittowords.com/get-started/scan-your-repo.md. That page also covers reviewing the style guide Ditto drafts from the scan. After it, the follow-on guides are Connect Figma files and Set up localization (under /guides/) and Connect the Ditto MCP (the Setup page of the MCP reference).
> Two different MCP servers: the Ditto MCP server at https://api.dittowords.com/v2/mcp gives an agent a workspace's text and style guide rules; the documentation MCP server at https://developer.dittowords.com/mcp searches these docs.
> Prefer logging in with a Ditto account (npx -y @dittowords/cli@latest login; OAuth in MCP clients) over API keys. API keys are for CI and headless clients only.
> Commands are complete as written and use npx -y @dittowords/cli@latest; nothing needs a global install.

# Fetch bases

> Returns a list of the bases in your workspace.

A base holds the text items scanned out of a codebase; projects connected to a base draw their text items from it.

<Badge color="blue" shape="pill">BETA</Badge> This endpoint is part of a feature that is still in development and will not be available until the feature has been released.



## OpenAPI

````yaml openapi.json get /bases
openapi: 3.0.0
info:
  version: 1.0.0
  title: Ditto API
  description: Programmatically read and write data in your Ditto workspace.
servers:
  - url: https://api.dittowords.com/v2
security: []
paths:
  /bases:
    get:
      tags:
        - Bases
      summary: Fetch bases
      description: >-
        Returns a list of the bases in your workspace.


        A base holds the text items scanned out of a codebase; projects
        connected to a base draw their text items from it.


        <Badge color="blue" shape="pill">BETA</Badge> This endpoint is part of a
        feature that is still in development and will not be available until the
        feature has been released.
      responses:
        '200':
          description: Returns an array of bases in the workspace
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: The Developer ID of the base
                    name:
                      type: string
                      description: The name of the base
                    githubConnection:
                      type: object
                      nullable: true
                      properties:
                        repoId:
                          type: number
                          description: The stable ID of the GitHub repository
                        owner:
                          type: string
                          description: The owner of the GitHub repository
                        repo:
                          type: string
                          description: The name of the GitHub repository
                      required:
                        - repoId
                        - owner
                        - repo
                      description: >-
                        The GitHub connection for the base, or null if none
                        exists
                    textItemCount:
                      type: number
                      description: The number of text items in the base
                  required:
                    - id
                    - name
                    - githubConnection
                    - textItemCount
                example:
                  - name: Web App
                    id: web-app
                    githubConnection:
                      repoId: 123456789
                      owner: dittowords
                      repo: web-app
                    textItemCount: 128
                  - name: Mobile App
                    id: mobile-app
                    githubConnection: null
                    textItemCount: 0
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.