# List plans (/docs/api/account/plans_list)

Every GridRouter plan with its price, limits, features and managed-call markup, plus the shared overage rates and always-free list.

`GET /v1/plans`

```json
{
  "operationId": "plans_list",
  "summary": "List plans",
  "description": "Every GridRouter plan with its price, limits, features and managed-call markup, plus the shared overage rates and always-free list.",
  "tags": [
    "plans"
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string",
                "enum": [
                  "list"
                ]
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "enum": [
                        "free",
                        "pro",
                        "team",
                        "agency",
                        "enterprise"
                      ]
                    },
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 40
                    },
                    "order": {
                      "type": "integer",
                      "minimum": 0
                    },
                    "tagline": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 140
                    },
                    "price": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "monthly_usd": {
                              "type": "number",
                              "minimum": 0
                            }
                          },
                          "required": [
                            "monthly_usd"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "from_monthly_usd": {
                              "type": "number",
                              "exclusiveMinimum": 0
                            }
                          },
                          "required": [
                            "from_monthly_usd"
                          ]
                        }
                      ]
                    },
                    "cta": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 40
                        },
                        "action": {
                          "type": "string",
                          "enum": [
                            "signup",
                            "checkout",
                            "contact"
                          ]
                        }
                      },
                      "required": [
                        "label",
                        "action"
                      ]
                    },
                    "highlight": {
                      "type": "boolean",
                      "default": false
                    },
                    "limits": {
                      "type": "object",
                      "properties": {
                        "logged_calls_month": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "log_retention_days": {
                          "anyOf": [
                            {
                              "type": "number",
                              "enum": [
                                30
                              ]
                            },
                            {
                              "type": "number",
                              "enum": [
                                90
                              ]
                            },
                            {
                              "type": "number",
                              "enum": [
                                360
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "cached_records": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "bodies_gb": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "workspaces": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "waterfalls": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "queues": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        },
                        "api_keys": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "unlimited"
                              ]
                            },
                            {
                              "type": "string",
                              "enum": [
                                "custom"
                              ]
                            }
                          ]
                        }
                      },
                      "required": [
                        "logged_calls_month",
                        "log_retention_days",
                        "cached_records",
                        "bodies_gb",
                        "workspaces",
                        "waterfalls",
                        "queues",
                        "api_keys"
                      ]
                    },
                    "features": {
                      "type": "object",
                      "properties": {
                        "live_tail": {
                          "type": "boolean"
                        },
                        "mcp_api_sdk": {
                          "type": "boolean"
                        },
                        "log_drains": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0
                            },
                            {
                              "type": "string",
                              "enum": [
                                "all"
                              ]
                            }
                          ]
                        },
                        "sql": {
                          "type": "boolean"
                        },
                        "anomaly_alerts": {
                          "type": "boolean"
                        },
                        "subscription_tracker": {
                          "type": "boolean"
                        },
                        "rebilling": {
                          "type": "boolean"
                        },
                        "white_label": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "live_tail",
                        "mcp_api_sdk",
                        "log_drains",
                        "sql",
                        "anomaly_alerts",
                        "subscription_tracker",
                        "rebilling",
                        "white_label"
                      ]
                    },
                    "managed_markup_pct": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "minimum": 0,
                      "maximum": 100
                    },
                    "highlights": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 90
                      },
                      "minItems": 2,
                      "maxItems": 8
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "order",
                    "tagline",
                    "price",
                    "cta",
                    "limits",
                    "features",
                    "managed_markup_pct",
                    "highlights"
                  ],
                  "additionalProperties": false
                }
              },
              "rules": {
                "type": "object",
                "properties": {
                  "currency": {
                    "type": "string",
                    "enum": [
                      "USD"
                    ]
                  },
                  "overages": {
                    "type": "object",
                    "properties": {
                      "logged_calls": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "minLength": 1
                          },
                          "unit_usd": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "per": {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "label",
                          "unit_usd",
                          "per",
                          "unit"
                        ]
                      },
                      "records_hot": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "minLength": 1
                          },
                          "unit_usd": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "per": {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "label",
                          "unit_usd",
                          "per",
                          "unit"
                        ]
                      },
                      "records_cold": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "minLength": 1
                          },
                          "unit_usd": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "per": {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "label",
                          "unit_usd",
                          "per",
                          "unit"
                        ]
                      },
                      "bodies": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "minLength": 1
                          },
                          "unit_usd": {
                            "type": "number",
                            "exclusiveMinimum": 0
                          },
                          "per": {
                            "type": "integer",
                            "exclusiveMinimum": 0
                          },
                          "unit": {
                            "type": "string",
                            "minLength": 1
                          }
                        },
                        "required": [
                          "label",
                          "unit_usd",
                          "per",
                          "unit"
                        ]
                      }
                    },
                    "required": [
                      "logged_calls",
                      "records_hot",
                      "records_cold",
                      "bodies"
                    ]
                  },
                  "always_free": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 120
                    },
                    "minItems": 1
                  },
                  "topup": {
                    "type": "object",
                    "properties": {
                      "fee_pct": {
                        "type": "number",
                        "exclusiveMinimum": 0
                      },
                      "fee_min_usd": {
                        "type": "number",
                        "exclusiveMinimum": 0
                      },
                      "presets_usd": {
                        "type": "array",
                        "items": {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        "minItems": 1
                      },
                      "min_usd": {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      },
                      "max_usd": {
                        "type": "integer",
                        "exclusiveMinimum": 0
                      }
                    },
                    "required": [
                      "fee_pct",
                      "fee_min_usd",
                      "presets_usd",
                      "min_usd",
                      "max_usd"
                    ]
                  },
                  "other_revenue": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 160
                    }
                  },
                  "storage_fairness": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        },
                        "body": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240
                        }
                      },
                      "required": [
                        "title",
                        "body"
                      ]
                    },
                    "minItems": 1
                  }
                },
                "required": [
                  "currency",
                  "overages",
                  "always_free",
                  "topup",
                  "other_revenue",
                  "storage_fairness"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "object",
              "items",
              "rules"
            ]
          }
        }
      }
    },
    "default": {
      "description": "Error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "enum": [
                      "invalid_request",
                      "unauthorized",
                      "insufficient_balance",
                      "max_cost_exceeded",
                      "scope_denied",
                      "budget_blocked",
                      "not_found",
                      "idempotency_mismatch",
                      "invalid_meta",
                      "rate_limited",
                      "upstream_error",
                      "response_buffer_limit",
                      "provider_capacity_unavailable",
                      "grid_saturated",
                      "upstream_timeout",
                      "conflict",
                      "internal_error",
                      "account_frozen",
                      "strict_filters",
                      "plan_limit_reached",
                      "validation_failed",
                      "deadline_exceeded",
                      "cancelled"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "request_id": {
                    "type": "string"
                  },
                  "call_id": {
                    "type": "string"
                  },
                  "retry_after_ms": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "details": {
                    "type": "object",
                    "additionalProperties": {}
                  }
                },
                "required": [
                  "code",
                  "message"
                ]
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```