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

# Get a single universe

> Returns the full `query_universe` row for one universe — name,
website, configured competitors and brand-token aliases, the
`result_json` blob (which holds the prompt list), location,
status, and timestamps. Use `/universes` for the catalogue
view; this endpoint is the "fetch one" sibling.




## OpenAPI

````yaml /openapi.yaml get /universes/{id}
openapi: 3.1.0
info:
  title: Verseodin API
  version: 1.0.0
  description: |
    Read-only HTTP API for pulling Verseodin dashboard data:
    universes, history rows (per-day aggregates of brand visibility,
    citations, and mentions across AI search engines), and full prompt
    records including the AI's response text and cited URLs.

    The same key authorises the Verseodin Claude / MCP connector — one
    credential, two surfaces.
servers:
  - url: https://verseodin.com/api/v1
    description: Production
security:
  - BearerAuth: []
paths:
  /universes/{id}:
    get:
      tags:
        - Universes
      summary: Get a single universe
      description: |
        Returns the full `query_universe` row for one universe — name,
        website, configured competitors and brand-token aliases, the
        `result_json` blob (which holds the prompt list), location,
        status, and timestamps. Use `/universes` for the catalogue
        view; this endpoint is the "fetch one" sibling.
      operationId: getUniverse
      parameters:
        - $ref: '#/components/parameters/UniverseId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Full query_universe row.
                    additionalProperties: true
              example:
                data:
                  id: 7f45877a-0e8e-498f-bd7f-5e70ef65a2de
                  user_id: 93ed3c1f-cc87-4e9b-9045-fd21a1694cd3
                  universe_name: Verseodin
                  website: https://verseodin.com/
                  status: completed
                  is_tracked: 'false'
                  day: '2026-04-27'
                  created_at: '2026-04-26T11:32:14Z'
                  result_json:
                    prompts:
                      - best AI visibility tool for brands
                      - best platform to track brand visibility in AI search
                    meta:
                      location: us
                      website: https://verseodin.com/
                      brand_tokens:
                        - verseodin
                      competitors:
                        - semrush.com
                        - tryprofound.com
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    UniverseId:
      name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
      description: Universe UUID — see `GET /universes`.
  responses:
    BadRequest:
      description: Malformed request (bad UUID, bad date, etc.).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing / invalid / revoked API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: API key is valid but doesn't own the requested universe.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Universe (or metric, or row) doesn't exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - type
            - message
          properties:
            type:
              type: string
              enum:
                - authentication_error
                - permission_error
                - not_found
                - invalid_request_error
                - rate_limit_error
                - api_error
              description: Machine-readable error category.
            message:
              type: string
              description: Human-readable explanation.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: vso_<48 hex chars>
      description: |
        Generate a key at `/dashboard/settings/api-keys`. Pass it as
        `Authorization: Bearer vso_xxx` on every request.

````