List and describe your models.

This endpoint allows you to list and describe the models you have previously created. The response contains:

  • The model name
  • Status
  • Input schema
  • Previous train time.

A model can have the following statuses:

  • Active - Live, deployed model. This means you can make Rank requests.
  • Preparing - Training for the first time and unable to receive Rank requests.
  • Error - In a failed state and unable to receive Rank requests.


Training and deploying may take some time (depending on the amount of data). While in this state, the model's status will be PREPARING. Until the status of the model is ACTIVE, calls to Rank will fail. Once the model is ACTIVE, it will remain ACTIVE until you delete it.