Families

Model families group related models from the same provider — for example, "Claude Sonnet" encompasses Claude 3 Sonnet, Claude 3.5 Sonnet, and Claude Sonnet 4.6.

List all families

GET /api/v1/families

Returns all model families. Supports filtering by provider and open-source status.

Query Parameters

Parameter	Type	Description
provider	string	Filter by provider slug (e.g. anthropic)
open_source	boolean	Filter by open-source status (true or false)

Examples

# All families
curl https://api.modelgraph.ai/api/v1/families

# Only Anthropic families
curl "https://api.modelgraph.ai/api/v1/families?provider=anthropic"

# Only open-source families
curl "https://api.modelgraph.ai/api/v1/families?open_source=true"

Response

{
  "families": [
    {
      "slug": "claude-sonnet",
      "name": "Claude Sonnet",
      "provider": {
        "slug": "anthropic",
        "name": "Anthropic"
      },
      "description": "Claude Sonnet series — balanced speed and intelligence",
      "is_open_source": false,
      "model_count": 5,
      "created_at": "2024-02-01T00:00:00Z",
      "updated_at": "2025-10-15T00:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
slug	string	URL-friendly unique identifier
name	string	Display name
provider	object	Provider summary (slug, name)
description	string | null	Description of the family
is_open_source	boolean	Whether models in this family are open-source
model_count	integer	Number of models in the family
created_at	string	ISO 8601 timestamp
updated_at	string	ISO 8601 timestamp

---

Get a family

GET /api/v1/families/{slug}

Returns a single family with all of its models ordered by release date. This is the timeline view — it shows how the family has evolved over time.

Path Parameters

Parameter	Type	Description
slug	string	Family slug (e.g. claude-sonnet, gpt-4o, llama-3)

Response

{
  "slug": "claude-sonnet",
  "name": "Claude Sonnet",
  "provider": {
    "slug": "anthropic",
    "name": "Anthropic"
  },
  "description": "Claude Sonnet series — balanced speed and intelligence",
  "is_open_source": false,
  "models": [
    {
      "slug": "claude-3-sonnet-20240229",
      "display_name": "Claude 3 Sonnet",
      "version": "3",
      "status": "deprecated",
      "release_date": "2024-02-29",
      "deprecation_date": "2025-01-15",
      "input_context_window": 200000,
      "output_context_window": 4096
    },
    {
      "slug": "claude-3-5-sonnet-20241022",
      "display_name": "Claude 3.5 Sonnet",
      "version": "3.5",
      "status": "active",
      "release_date": "2024-10-22",
      "input_context_window": 200000,
      "output_context_window": 8192
    },
    {
      "slug": "claude-sonnet-4-6",
      "display_name": "Claude Sonnet 4.6",
      "version": "4.6",
      "status": "latest",
      "release_date": "2025-10-15",
      "input_context_window": 200000,
      "output_context_window": 16384
    }
  ],
  "created_at": "2024-02-01T00:00:00Z",
  "updated_at": "2025-10-15T00:00:00Z"
}

Errors

Status	Code	Description
404	not_found	Family with the given slug doesn't exist