Browsing Models

The JAOT marketplace is a catalog of pre-built optimization models published by organizations and the JAOT team. You can browse, evaluate, and activate models without writing any formulation code.

Accessing the Marketplace

The public marketplace is available at /marketplace and does not require authentication to browse. Anyone can view model listings, read descriptions, and check input schemas. Authentication is only required when activating (purchasing) a model.

Search and Filter Controls

The marketplace provides several ways to find relevant models:

Pagination

Results are paginated with a default page size of 20. Use the page controls at the bottom to navigate through the catalog.

Model Cards

Each model in the catalog is displayed as a card with key information:

• Display name -- The model's title
• Short description -- A one-line summary of what the model solves
• Category -- The industry or domain tag
• Price -- In EUR (or "Free" for no-cost models)
• Rating -- Average user rating out of 5 stars
• Activations -- How many organizations have activated the model
• Official badge -- Present on models published and verified by JAOT

Model Detail Page

Click on a model card to view its full detail page, which includes:

Overview

A comprehensive description of the optimization problem the model solves, including the mathematical approach, typical use cases, and expected results.

Features

Key capabilities and characteristics of the model, such as supported variable types, constraint patterns, and solver behavior.

How It Works

A walkthrough of the model's logic: how input data is transformed into an optimization problem, what the solver computes, and how results are structured.

Input Schema

The exact JSON schema required to execute the model. This tells you what fields to provide, their types, and any validation rules:

{
  "capacity": 50,
  "items": [
    {
      "name": "widget_a",
      "value": 120,
      "weight": 8
    }
  ]
}

Example Input/Output

A worked example showing a sample input and the corresponding solution, so you can understand what to expect before activating.

Reviews

User reviews with ratings and comments from organizations that have activated and used the model.

Activating a Model

To use a marketplace model, you need to activate it for your organization:

1. Navigate to the model detail page
2. Click Activate (or Purchase for paid models)
3. For paid models, the price in EUR is charged to your organization's balance
4. The model appears in your My Models list immediately after activation

Note: Activation is an organization-level action. Once activated, all members of your organization can execute the model.

Free vs. Paid Models

Both free and paid models consume credits when executed. The activation price covers access to the model; solve credits cover the compute cost of running the SCIP solver.

After Activation

Once activated, the model appears in My Models where you can:

• Execute the model with your own input data
• View execution history -- past runs with their results
• Check input schema -- reference the required data format
• Deactivate -- remove the model from your organization (paid models cannot be refunded)

Executing an Activated Model

Provide your input data matching the model's schema and run:

import httpx
 
headers = {"Authorization": "Bearer ok_live_your_key_here"}
 
response = httpx.post(
    "https://api.jaot.io/api/v2/models/orgmdl_abc123/execute",
    headers=headers,
    json={
        "input_data": {
            "capacity": 50,
            "items": [
                {"name": "laptop", "value": 600, "weight": 10},
                {"name": "camera", "value": 500, "weight": 5},
            ],
        },
    },
)
 
result = response.json()
print(f"Status: {result['status']}")
print(f"Objective: {result['objective_value']}")

Browsing via API

The catalog is also accessible through the REST API and MCP:

# List all published models (no auth required)
curl "https://api.jaot.io/api/v2/models/catalog?sort_by=popular&page_size=10"
 
# Search by keyword
curl "https://api.jaot.io/api/v2/models/catalog?search=routing"
 
# Filter by category and price
curl "https://api.jaot.io/api/v2/models/catalog?category=logistics&max_price=50"
 
# Get model details
curl "https://api.jaot.io/api/v2/models/catalog/cat_abc123"
 
# Get model input schema
curl "https://api.jaot.io/api/v2/models/catalog/cat_abc123/schema"

See the Models API reference for full endpoint documentation.