# Models

## Retrieve

**get** `/models/{model}`

Retrieves a model instance, providing basic information about the model such as the owner and permissioning.

### Returns

- **id:** `string`

  The model identifier, which can be referenced in the API endpoints.

- **created:** `number`

  The Unix timestamp (in seconds) when the model was created.

- **object:** `"model"`

  The object type, which is always "model".

  - `"model"`

- **owned\_by:** `string`

  The organization that owns the model.

## List

**get** `/models`

Lists the currently available models, and provides basic information about each one such as the owner and availability.

### Returns

- **data:** `array of object`

  - **id:** `string`

    The model identifier, which can be referenced in the API endpoints.

  - **created:** `number`

    The Unix timestamp (in seconds) when the model was created.

  - **object:** `"model"`

    The object type, which is always "model".

    - `"model"`

  - **owned\_by:** `string`

    The organization that owns the model.

- **object:** `"list"`

  - `"list"`

## Domain Types

### API Agreement

- **APIAgreement:** `object`

  Agreement Description

  - **description:** `string`

  - **name:** `string`

  - **url:** `string`

  - **uuid:** `string`

### API Model

- **APIModel:** `object`

  A machine learning model stored on the GenAI platform

  - **agreement:** `APIAgreement`

    Agreement Description

  - **created\_at:** `string`

    Creation date / time

  - **is\_foundational:** `boolean`

    True if it is a foundational model provided by do

  - **name:** `string`

    Name of the model

  - **parent\_uuid:** `string`

    Unique id of the model, this model is based on

  - **updated\_at:** `string`

    Last modified

  - **upload\_complete:** `boolean`

    Model has been fully uploaded

  - **url:** `string`

    Download url

  - **uuid:** `string`

    Unique id

  - **version:** `APIModelVersion`

    Version Information about a Model

### API Model Version

- **APIModelVersion:** `object`

  Version Information about a Model

  - **major:** `number`

    Major version number

  - **minor:** `number`

    Minor version number

  - **patch:** `number`

    Patch version number