GET /v1/models — List and Retrieve Models on Swytcho

The models endpoints let you discover which AI models your API key can access and inspect the details of any individual model. Use these endpoints at runtime to build dynamic model selectors, validate a model ID before sending a generation request, or check when a model was added to the platform.

Endpoints

List all models

GET https://api.swytcho.com/v1/models

Returns an array of all models available to your account, including chat, completion, and embedding models.

Get a specific model

GET https://api.swytcho.com/v1/models/{model_id}

Returns the details for a single model identified by its model_id. Returns a 404 Not Found error if the model does not exist or is not accessible with your API key.

Path Parameter	Type	Description
`model_id`	string	The unique identifier of the model (e.g., `swytcho-pro`).

Request Examples

curl https://api.swytcho.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.swytcho.com/v1/models/swytcho-pro \
  -H "Authorization: Bearer YOUR_API_KEY"

import os
from swytcho import Swytcho

client = Swytcho(api_key=os.environ["SWYTCHO_API_KEY"])

# List all models
models = client.models.list()
for model in models.data:
    print(model.id)

# Get a specific model
model = client.models.retrieve("swytcho-pro")
print(model.id, model.owned_by)

import Swytcho from "swytcho";

const client = new Swytcho({ apiKey: process.env.SWYTCHO_API_KEY });

// List all models
const models = await client.models.list();
for (const model of models.data) {
  console.log(model.id);
}

// Get a specific model
const model = await client.models.retrieve("swytcho-pro");
console.log(model.id, model.owned_by);

Response Fields

Each model object in the API response contains the following fields.

string

The unique identifier for the model (e.g., "swytcho-pro"). Pass this value as the model parameter in chat, completion, and embedding requests.

string

Always "model".

integer

Unix timestamp (seconds) indicating when this model was made available on the platform.

string

The organization that owns and maintains this model (e.g., "swytcho" for first-party models or the provider name for third-party models).

Example Response — List All Models

{
  "object": "list",
  "data": [
    {
      "id": "swytcho-pro",
      "object": "model",
      "created": 1710000000,
      "owned_by": "swytcho"
    },
    {
      "id": "swytcho-base",
      "object": "model",
      "created": 1710000001,
      "owned_by": "swytcho"
    },
    {
      "id": "swytcho-embed-v1",
      "object": "model",
      "created": 1710000002,
      "owned_by": "swytcho"
    }
  ]
}

Example Response — Single Model

{
  "id": "swytcho-pro",
  "object": "model",
  "created": 1710000000,
  "owned_by": "swytcho"
}

Call GET /v1/models at application startup to build a dynamic list of available models rather than hard-coding model IDs. This ensures your application automatically surfaces newly released models and gracefully handles the removal of deprecated ones without requiring a code deployment.

​Endpoints

​List all models

​Get a specific model

​Request Examples

​Response Fields

​Example Response — List All Models

​Example Response — Single Model

Endpoints

List all models

Get a specific model

Request Examples

Response Fields

Example Response — List All Models

Example Response — Single Model