> ## Documentation Index > Fetch the complete documentation index at: https://docs.near.ai/llms.txt > Use this file to discover all available pages before exploring further. # List all models (Admin only) > Returns a paginated list of all models in the system. By default, only active models are returned. Use `include_inactive=true` to also include disabled models. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/admin/models openapi: 3.1.0 info: title: NEAR AI Cloud API description: >- NEAR AI Cloud API for private AI model inference and organization administration. contact: name: NEAR AI Team email: support@near.ai license: name: MIT version: 1.0.0 servers: - url: https://cloud-api.near.ai description: NEAR AI Cloud security: - session_token: [] - api_key: [] tags: - name: Chat description: Chat completion endpoints for AI model inference - name: Images description: Image generation endpoints - name: Audio description: Audio transcription endpoints - name: Rerank description: Document reranking endpoints - name: Score description: Text similarity scoring endpoints - name: Privacy description: Privacy classification (PII span detection) endpoints - name: Models description: Public model catalog and information - name: Responses description: >- Stateless response inference (`store: false` only). Raw request/response content, response items, and history are not persisted. Clients must include any prior context in each request. Every successful Responses inference makes exactly one Chat Completions call. Only custom `function` tools are supported. They are client-managed: Cloud returns `function_call` items but never executes them; a later `store: false` request replays the individual call (the raw item from output is accepted) with its matching `function_call_output`, alongside caller-managed message history and the same function tool definitions. The minimal replay path also accepts assistant `message` text parts of type `output_text`, but not reasoning or arbitrary full `response.output` items. Server-executed tools (`web_search`, `web_context_search`, `file_search`, `code_interpreter`, `computer`, and remote `mcp`) and image-generation/editing models are rejected. The separate `POST /mcp` endpoint continues to expose its `web_search` tool independently of Responses; use `/v1/images/*` for image generation/editing. Existing completed-response gateway attestation is preserved best-effort: when the signature write succeeds, `GET /v1/signature/resp_*` retrieves signatures over SHA-256 request/response digests, never raw content. Interrupted streams create no `resp_*` attestation record or legacy disconnect fallback. Conversations, response history, and file input are rejected. - name: Organizations description: Organization management - name: Organization Members description: Organization member and invitation management - name: Workspaces description: Workspace and API key management - name: Users description: User profile and token management - name: Invitations description: Token-based invitation handling - name: Usage description: Usage tracking and billing information - name: Reporting description: Read-only customer usage reporting - name: Billing description: Billing costs endpoint (HuggingFace integration) - name: Staking Farm description: House of Stake farm credit configuration and synchronization - name: Health description: Health check endpoints - name: Attestation description: Attestation and verification endpoints - name: Gateway description: Model gateway integration endpoints - name: Admin description: Administrative endpoints (admin access required) - name: Services description: Public platform services (e.g. web_search pricing) paths: /v1/admin/models: get: tags: - Admin summary: List all models (Admin only) description: >- Returns a paginated list of all models in the system. By default, only active models are returned. Use `include_inactive=true` to also include disabled models. operationId: list_models parameters: - name: limit in: query description: 'Maximum number of models to return (default: 100)' required: false schema: type: integer format: int64 - name: offset in: query description: 'Number of models to skip (default: 0)' required: false schema: type: integer format: int64 - name: include_inactive in: query description: 'Whether to include inactive (disabled) models (default: false)' required: false schema: type: boolean responses: '200': description: Models retrieved successfully content: application/json: schema: $ref: '#/components/schemas/AdminModelListResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - session_token: [] components: schemas: AdminModelListResponse: type: object description: Response for admin model list endpoint required: - models - limit - offset - total properties: limit: type: integer format: int64 models: type: array items: $ref: '#/components/schemas/AdminModelWithPricing' offset: type: integer format: int64 total: type: integer format: int64 ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorDetail' AdminModelWithPricing: type: object description: Model with pricing information for admin listing required: - modelId - inputCostPerToken - outputCostPerToken - costPerImage - metadata - isActive - createdAt - updatedAt properties: cacheReadCostPerToken: oneOf: - type: 'null' - $ref: '#/components/schemas/DecimalPrice' description: >- Cost per cached input token. Omitted when cache pricing is disabled; an amount of 0 means cached tokens are genuinely free. costPerImage: $ref: '#/components/schemas/DecimalPrice' createdAt: type: string format: date-time inputCostPerToken: $ref: '#/components/schemas/DecimalPrice' isActive: type: boolean metadata: $ref: '#/components/schemas/ModelMetadata' modelId: type: string outputCostPerToken: $ref: '#/components/schemas/DecimalPrice' updatedAt: type: string format: date-time ErrorDetail: type: object required: - message - type properties: code: type: - string - 'null' message: type: string param: type: - string - 'null' type: type: string DecimalPrice: type: object description: >- Decimal price for API responses The system uses a fixed scale of 9 (nano-dollars = 1 billionth of a dollar). The scale field is included in responses for client convenience. required: - amount - scale - currency properties: amount: type: integer format: int64 currency: type: string scale: type: integer format: int64 ModelMetadata: type: object description: Model metadata required: - verifiable - contextLength - modelDisplayName - modelDescription - ownedBy - providerType - attestationSupported properties: aliases: type: array items: type: string architecture: oneOf: - type: 'null' - $ref: '#/components/schemas/ModelArchitecture' description: Model architecture (input/output modalities) attestationSupported: type: boolean description: Whether this model supports TEE attestation contextLength: type: integer format: int32 datacenters: type: - array - 'null' items: $ref: '#/components/schemas/Datacenter' description: |- Datacenters the model runs in (OpenRouter `datacenters`), e.g. `[{ "country_code": "US" }]`. Omitted when unset. deprecationDate: type: - string - 'null' description: >- OpenRouter `deprecation_date`: planned deprecation date as an ISO 8601 string. Omitted when there is no planned deprecation. huggingFaceId: type: - string - 'null' description: HuggingFace identifier (OpenRouter `hugging_face_id`). inferenceUrl: type: - string - 'null' description: Base URL for the model's inference endpoint isReady: type: - boolean - 'null' description: 'OpenRouter `is_ready`: stored/exposed verbatim. Omitted when unset.' maxOutputLength: type: - integer - 'null' format: int32 description: Maximum output tokens per response (OpenRouter `max_output_length`). modelDescription: type: string modelDisplayName: type: string modelIcon: type: - string - 'null' openrouterSlug: type: - string - 'null' description: >- OpenRouter `openrouter.slug` override (lowercase `author/slug`). Omitted when unset. On public `GET /v1/models` this surfaces as the nested `openrouter: { slug }` object; the admin view exposes the raw value. ownedBy: type: string providerConfig: description: JSON config for external providers (backend, base_url, etc.) providerType: type: string description: 'Provider type: "vllm" (TEE-enabled) or "external" (3rd party)' quantization: type: - string - 'null' description: Quantization label (int4/int8/fp4/fp6/fp8/fp16/bf16/fp32). supportedFeatures: type: array items: type: string description: Feature capabilities (OpenRouter `supported_features`). supportedSamplingParameters: type: array items: type: string description: >- Sampling parameters accepted by the model (OpenRouter `supported_sampling_parameters`). verifiable: type: boolean ModelArchitecture: type: object description: Model architecture describing input/output modalities required: - inputModalities - outputModalities properties: inputModalities: type: array items: type: string description: >- Input modalities the model accepts, e.g., ["text"], ["text", "image"] outputModalities: type: array items: type: string description: Output modalities the model produces, e.g., ["text"], ["image"] Datacenter: type: object description: |- OpenRouter `datacenters` entry: a single datacenter the model runs in. The provider spec (https://openrouter.ai/docs/guides/community/for-providers) models `datacenters` as an array of objects, each with an ISO 3166 Alpha-2 `country_code`. We store only the country codes (a `TEXT[]`) and reconstruct this object wrapper at serialization time. required: - country_code properties: country_code: type: string description: ISO 3166 Alpha-2 country code (e.g. "US"), uppercase. securitySchemes: session_token: type: http scheme: bearer bearerFormat: JWT description: >- JWT access token for user authentication (Authorization: Bearer ). Create via POST /users/me/access_tokens. api_key: type: http scheme: bearer bearerFormat: api_key description: 'API key for programmatic access (Authorization: Bearer sk-)' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.