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

# List organization models

> Lists custom models shared with every project in the specified organization. Project-private and public models are not included.



## OpenAPI

````yaml GET /organizations/{organizationId}/models
openapi: 3.1.0
info:
  title: Together APIs
  description: The Together REST API. See https://docs.together.ai for more details.
  version: 2.0.0
  termsOfService: https://www.together.ai/terms-of-service
  contact:
    name: Together Support
    url: https://www.together.ai/contact
  license:
    name: MIT
    url: https://github.com/togethercomputer/openapi/blob/main/LICENSE
servers:
  - url: https://api.together.ai/v1
    description: Default environment for APIs
  - url: https://api-inference.together.ai/v2
    description: Optimized environment for inference
security:
  - bearerAuth: []
paths:
  /organizations/{organizationId}/models:
    get:
      tags:
        - VolumeService
      summary: List organization models
      description: >-
        Lists custom models shared with every project in the specified
        organization. Project-private and public models are not included.
      operationId: VolumeService_ListOrganizationModels
      parameters:
        - name: organizationId
          in: path
          required: true
          schema:
            description: Organization identifier.
            type: string
        - name: limit
          in: query
          schema:
            type: integer
            description: Maximum number of results to return.
        - name: after
          in: query
          schema:
            type: string
            description: Cursor from a previous list response.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DE.ListModelsResponse'
        default:
          description: Default error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorData'
      servers:
        - url: https://api.together.ai/v2
components:
  schemas:
    DE.ListModelsResponse:
      type: object
      description: Custom model resources and pagination metadata.
      required:
        - data
        - object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/DE.Model'
          description: The list of models.
        next_cursor:
          type: string
          description: Cursor for the next page. Null if there are no more results.
        object:
          const: list
          description: Object type. Always `list`.
    ErrorData:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              nullable: false
            type:
              type: string
              nullable: false
            param:
              type: string
              nullable: true
              default: null
            code:
              type: string
              nullable: true
              default: null
          required:
            - type
            - message
    DE.Model:
      description: >-
        Custom or derived model registered in a project and backed by versioned
        weight files.
      type: object
      required:
        - id
        - projectId
        - organizationId
        - name
        - weights
        - visibility
      properties:
        id:
          type: string
          description: Unique model identifier.
        projectId:
          type: string
          description: ID of the project that owns the model.
        organizationId:
          type: string
          description: ID of the organization that owns the model's project.
        name:
          type: string
          description: >-
            Project-qualified model name in the form
            `<project_slug>/<model_name>`. Create and update requests may use
            the bare or qualified form.
        description:
          type: string
          description: Human-readable description of the model and its intended use.
        weights:
          $ref: '#/components/schemas/DE.ModelWeights'
          description: >-
            Architecture, size, precision, and speculative-decoding metadata
            derived from the model files.
        baseModelId:
          type: string
          description: >-
            ID of the supported or custom base model from which this model was
            derived.
        baseModel:
          type: string
          readOnly: true
          description: >-
            Resource name of the base model, using
            `projects/{baseProject}/models/{baseModelId}`; empty when the model
            has no base.
        visibility:
          default: VISIBILITY_PRIVATE
          enum:
            - VISIBILITY_PRIVATE
            - VISIBILITY_INTERNAL
          type: string
          description: >-
            Who can discover the model. `VISIBILITY_PRIVATE` restricts it to the
            project; `VISIBILITY_INTERNAL` shares it with the organization.
    DE.ModelWeights:
      type: object
      properties:
        type:
          enum:
            - WEIGHTS_TYPE_DEFAULT
            - WEIGHTS_TYPE_SPECULATOR
            - WEIGHTS_TYPE_ADAPTER
          type: string
          description: >-
            Role of the weights: full model, speculative draft model, or LoRA
            adapter.
        speculatorMechanism:
          enum:
            - SPECULATOR_MECHANISM_DRAFT
            - SPECULATOR_MECHANISM_LOOKAHEAD
            - SPECULATOR_MECHANISM_MTP
          type: string
          description: Speculative decoding mechanism for speculator weights.
        draftSpeculatorType:
          enum:
            - DRAFT_SPECULATOR_TYPE_EAGLE
            - DRAFT_SPECULATOR_TYPE_PHOENIX
          type: string
          description: Draft-model speculator family for draft speculative decoding.
        architecture:
          type: string
          description: Model architecture detected from the weight metadata.
        contextLength:
          type: string
          description: Maximum context length reported by the model metadata.
        parameters:
          $ref: '#/components/schemas/DE.ModelParameters'
          description: Total parameter count and breakdown by numerical data type.
      description: >-
        Architecture, size, precision, and speculative-decoding metadata for
        model weights.
    DE.ModelParameters:
      type: object
      required:
        - total
        - byDtype
      properties:
        total:
          type: string
          description: Total number of parameters in the model weights.
        byDtype:
          type: array
          items:
            $ref: '#/components/schemas/DE.ModelDTypeCount'
          description: Parameter counts grouped by numerical data type.
      description: Model parameter count and precision breakdown.
    DE.ModelDTypeCount:
      type: object
      required:
        - dtype
        - count
      properties:
        dtype:
          type: string
          description: Numerical data type, such as `float16`, `bfloat16`, or `int8`.
        count:
          type: string
          description: Number of model parameters stored with this data type.
      description: Number of model parameters stored in one numerical data type.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-bearer-format: bearer
      x-default: default

````