---
title: "List AI models and provider descriptors in an organization"
method: GET
path: "/api/v2/organizations/{organization}/chats/models"
tags: ["Chats"]
---

# List AI models and provider descriptors in an organization

`GET /api/v2/organizations/{organization}/chats/models`

## Path parameters

- `organization` string, required

## Response `200`

OK

- CodersdkOrganizationChatModelsResponse
  - `models` CodersdkChatModel[]
    - `ai_provider_id` string, uuid
    - `compression_threshold` integer
    - `context_limit` integer
    - `created_at` string, date-time
    - `display_name` string
    - `enabled` boolean
    - `id` string, uuid
    - `is_default` boolean
    - `model` string
    - `model_config` CodersdkChatModelCallConfig
      - `frequency_penalty` number
      - `max_output_tokens` integer
      - `openai_config` CodersdkChatModelOpenAIConfig
        - `use_responses_api` boolean
      - `presence_penalty` number
      - `provider_options` CodersdkChatModelProviderOptions
        - `anthropic` CodersdkChatModelAnthropicProviderOptions
          - `allowed_domains` string[]
          - `blocked_domains` string[]
          - `context_1m_enabled` boolean
          - `disable_parallel_tool_use` boolean
          - `send_reasoning` boolean
          - `thinking` CodersdkChatModelAnthropicThinkingOptions
            - `budget_tokens` integer
          - `thinking_display` string
          - `web_search_enabled` boolean
        - `google` CodersdkChatModelGoogleProviderOptions
          - `cached_content` string
          - `safety_settings` CodersdkChatModelGoogleSafetySetting[]
            - `category` string
            - `threshold` string
          - `thinking_config` CodersdkChatModelGoogleThinkingConfig
            - `include_thoughts` boolean
            - `thinking_budget` integer
            - `thinking_level` string
          - `threshold` string
          - `web_search_enabled` boolean
        - `openai` CodersdkChatModelOpenAIProviderOptions
          - `allowed_domains` string[]
          - `include` string[]
          - `instructions` string
          - `log_probs` boolean
          - `logit_bias` object
          - `max_completion_tokens` integer
          - `max_tool_calls` integer
          - `metadata` object
          - `parallel_tool_calls` boolean
          - `prediction` object
          - `prompt_cache_key` string
          - `reasoning_summary` string
          - `safety_identifier` string
          - `search_context_size` string
          - `service_tier` string
          - `store` boolean
          - `strict_json_schema` boolean
          - `structured_outputs` boolean
          - `text_verbosity` string
          - `top_log_probs` integer
          - `user` string
          - `web_search_enabled` boolean
        - `openaicompat` CodersdkChatModelOpenAICompatProviderOptions
          - `user` string
        - `openrouter` CodersdkChatModelOpenRouterProviderOptions
          - `extra_body` object
          - `include_usage` boolean
          - `log_probs` boolean
          - `logit_bias` object
          - `parallel_tool_calls` boolean
          - `provider` CodersdkChatModelOpenRouterProvider
            - `allow_fallbacks` boolean
            - `data_collection` string
            - `ignore` string[]
            - `only` string[]
            - `order` string[]
            - `quantizations` string[]
            - `require_parameters` boolean
            - `sort` string
          - `reasoning` CodersdkChatModelReasoningOptions
            - `enabled` boolean
            - `exclude` boolean
            - `max_tokens` integer
          - `user` string
        - `vercel` CodersdkChatModelVercelProviderOptions
          - `extra_body` object
          - `logit_bias` object
          - `logprobs` boolean
          - `parallel_tool_calls` boolean
          - `providerOptions` CodersdkChatModelVercelGatewayProviderOptions
            - `models` string[]
            - `order` string[]
          - `reasoning` CodersdkChatModelReasoningOptions
            - `enabled` boolean
            - `exclude` boolean
            - `max_tokens` integer
          - `top_logprobs` integer
          - `user` string
      - `reasoning_effort` CodersdkChatModelReasoningEffortConfig
        - `default` string
        - `max` string
      - `temperature` number
      - `top_k` integer
      - `top_p` number
    - `organization_id` string, uuid
    - `reasoning_efforts` string[] — ReasoningEfforts lists selectable reasoning effort values through the model's configured maximum.
    - `updated_at` string, date-time
  - `providers` CodersdkChatModelProviderDescriptor[]
    - `allow_user_api_key` boolean
    - `available` boolean
    - `display_name` string
    - `enabled` boolean
    - `has_api_key` boolean
    - `has_effective_api_key` boolean
    - `has_user_api_key` boolean
    - `icon` string
    - `id` string, uuid
    - `type` string
    - `unavailable_reason` 'missing_api_key' | 'fetch_failed' | 'user_api_key_required'
  - `unsupported_providers` CodersdkChatUnsupportedProvider[]
    - `display_name` string
    - `provider` string — Provider is the provider type, e.g. "copilot".

---

[API](https://skmtc.dev/coder/apis/coder-api.md) · [All operations](https://skmtc.dev/coder/apis/coder-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coder/coder-api/revisions/369ae60ab00e/schema)