{
	"name": "Liquid Web Agent Card",
	"description": "Canonical agent card for Liquid Web VPS endpoints. Embeds JSON Schemas for getPlans, getPromotions, and configure. Live data is served from the listed endpoints.",
	"version": "1.0.0",
	"last_updated": "2025-10-13T00:00:00Z",
	"endpoints": [
		{
			"capability": "get_plans",
			"method": "GET",
			"url": "/get-plans.json",
			"auth": "none",
			"content_type": "application/json",
			"schema": {
				"output_json_schema": {
					"$schema": "https://json-schema.org/draft/2020-12/schema",
					"$id": "https://www.liquidweb.com/get-plans.json",
					"title": "getPlans \u2013 Combined VPS",
					"description": "Live plan data for Managed Linux VPS, Managed Windows VPS, and Cloud VPS.",
					"type": "object",
					"required": [
						"data"
					],
					"properties": {
						"api_version": {
							"type": "string"
						},
						"data": {
							"type": "object",
							"required": [
								"plans"
							],
							"properties": {
								"product_lines": {
									"type": "array",
									"items": {
										"type": "string"
									}
								},
								"plans": {
									"type": "array",
									"minItems": 1,
									"items": {
										"type": "object",
										"required": [
											"id",
											"name",
											"currency"
										],
										"properties": {
											"id": {
												"type": "string"
											},
											"product_line": {
												"type": "string"
											},
											"name": {
												"type": "string"
											},
											"optimization": {
												"type": "string"
											},
											"vCPU": {
												"anyOf": [
													{
														"type": "number"
													},
													{
														"type": "integer"
													},
													{
														"type": "string"
													}
												]
											},
											"memory": {
												"type": "string"
											},
											"storage": {
												"type": "string"
											},
											"bandwidth": {
												"type": "string"
											},
											"os": {
												"type": "string"
											},
											"features": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"benefits": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"use_cases": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"pricing_model": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"currency": {
												"type": "string"
											},
											"list_price": {
												"anyOf": [
													{
														"type": "number"
													},
													{
														"type": "integer"
													}
												]
											},
											"list_price_display": {
												"type": "string"
											},
											"promotions_applied": {
												"type": "array",
												"items": {
													"type": "object",
													"required": [
														"type"
													],
													"properties": {
														"type": {
															"type": "string"
														},
														"value": {
															"type": "number"
														}
													},
													"additionalProperties": false
												}
											},
											"canonical_url": {
												"type": "string",
												"format": "uri"
											},
											"checkout_url": {
												"type": "string",
												"format": "uri"
											}
										},
										"additionalProperties": false
									}
								}
							},
							"additionalProperties": false
						},
						"metadata": {
							"type": "object",
							"properties": {
								"title": {
									"type": "string"
								},
								"description": {
									"type": "string"
								},
								"updated_at": {
									"type": "string",
									"format": "date-time"
								},
								"canonical_url": {
									"type": "string",
									"format": "uri"
								},
								"schema": {
									"type": "string",
									"format": "uri"
								}
							},
							"additionalProperties": true
						}
					},
					"additionalProperties": false
				}
			}
		},
		{
			"capability": "get_promotions",
			"method": "GET",
			"url": "/get-promotions.json",
			"auth": "none",
			"content_type": "application/json",
			"schema": {
				"output_json_schema": {
					"$schema": "https://json-schema.org/draft/2020-12/schema",
					"$id": "https://www.liquidweb.com/get-promotions.json",
					"title": "getPromotions",
					"description": "Promotions with scope, eligibility, and timing. Numeric magnitude intentionally omitted.",
					"type": "object",
					"required": [
						"data"
					],
					"properties": {
						"api_version": {
							"type": "string"
						},
						"data": {
							"type": "object",
							"required": [
								"promotions"
							],
							"properties": {
								"promotions": {
									"type": "array",
									"items": {
										"type": "object",
										"required": [
											"id",
											"name"
										],
										"properties": {
											"id": {
												"type": "string"
											},
											"name": {
												"type": "string"
											},
											"discount_type": {
												"type": "string"
											},
											"applies_to_skus": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"product_lines": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"eligible_terms": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"eligible_regions": {
												"type": "array",
												"items": {
													"type": "string"
												}
											},
											"stackable": {
												"type": "boolean"
											},
											"terms_url": {
												"type": "string",
												"format": "uri"
											},
											"starts": {
												"type": "string",
												"format": "date-time"
											},
											"ends": {
												"type": "string",
												"format": "date-time"
											},
											"canonical_source": {
												"type": "string",
												"format": "uri"
											},
											"notes": {
												"type": "string"
											},
											"extras": {
												"type": "object",
												"additionalProperties": {
													"type": "string"
												}
											}
										},
										"additionalProperties": false
									}
								}
							},
							"additionalProperties": false
						},
						"metadata": {
							"type": "object",
							"properties": {
								"title": {
									"type": "string"
								},
								"description": {
									"type": "string"
								},
								"updated_at": {
									"type": "string",
									"format": "date-time"
								},
								"canonical_url": {
									"type": "string",
									"format": "uri"
								},
								"schema": {
									"type": "string",
									"format": "uri"
								}
							},
							"additionalProperties": true
						}
					},
					"additionalProperties": false
				}
			}
		},
		{
			"capability": "configure",
			"method": "GET",
			"url": "/configure-server.json",
			"auth": "none",
			"content_type": "application/json",
			"schema": {
				"output_json_schema": {
					"$schema": "https://json-schema.org/draft/2020-12/schema",
					"$id": "https://www.liquidweb.com/configure.json",
					"title": "configure",
					"description": "Map of configuration UIs, checkout URLs, and per-product taxonomies. Fields are omitted when not applicable to a given product.",
					"type": "object",
					"required": [
						"data"
					],
					"properties": {
						"api_version": {
							"type": "string"
						},
						"data": {
							"type": "object",
							"required": [
								"configurators"
							],
							"properties": {
								"productTypes": {
									"type": "array",
									"items": {
										"type": "string"
									}
								},
								"configurators": {
									"type": "array",
									"items": {
										"type": "object",
										"required": [
											"config_id",
											"title"
										],
										"properties": {
											"config_id": {
												"type": "string"
											},
											"title": {
												"type": "string"
											},
											"product": {
												"type": "string"
											},
											"description": {
												"type": "string"
											},
											"config_url": {
												"type": "string",
												"format": "uri"
											},
											"checkout_url": {
												"type": "string",
												"format": "uri"
											},
											"taxonomy": {
												"type": "object",
												"description": "Only fields applicable to the product are included per item.",
												"additionalProperties": {
													"anyOf": [
														{
															"type": "string"
														},
														{
															"type": "number"
														},
														{
															"type": "array",
															"items": {
																"anyOf": [
																	{
																		"type": "string"
																	},
																	{
																		"type": "number"
																	}
																]
															}
														}
													]
												},
												"properties": {
													"cpu": {
														"anyOf": [
															{
																"type": "string"
															},
															{
																"type": "number"
															},
															{
																"type": "array"
															}
														]
													},
													"vcpu": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"cores": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"ram_gb": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"memory_ram": {
														"anyOf": [
															{
																"type": "string"
															},
															{
																"type": "array",
																"items": {
																	"type": "string"
																}
															}
														]
													},
													"storage_gb": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"storage": {
														"anyOf": [
															{
																"type": "string"
															},
															{
																"type": "array",
																"items": {
																	"type": "string"
																}
															}
														]
													},
													"storage_type": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"gpu_model": {
														"anyOf": [
															{
																"type": "string"
															},
															{
																"type": "array",
																"items": {
																	"type": "string"
																}
															}
														]
													},
													"gpu_count": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"gpu_memory_gb": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"bandwidth_tb": {
														"anyOf": [
															{
																"type": "number"
															},
															{
																"type": "array",
																"items": {
																	"type": "number"
																}
															}
														]
													},
													"bandwidth": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"billing_terms": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"datacenters": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"regions": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"os": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"control_panel": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"addons": {
														"type": "array",
														"items": {
															"type": "string"
														}
													},
													"extras": {
														"type": "array",
														"items": {
															"type": "string"
														}
													}
												}
											},
											"lastUpdated": {
												"type": "string",
												"format": "date-time"
											}
										},
										"additionalProperties": false
									}
								}
							},
							"additionalProperties": false
						},
						"metadata": {
							"type": "object",
							"properties": {
								"title": {
									"type": "string"
								},
								"description": {
									"type": "string"
								},
								"updated_at": {
									"type": "string",
									"format": "date-time"
								},
								"canonical_url": {
									"type": "string",
									"format": "uri"
								},
								"schema": {
									"type": "string",
									"format": "uri"
								}
							},
							"additionalProperties": true
						}
					},
					"additionalProperties": false
				}
			}
		}
	],
	"metadata": {
		"documentation_url": "https://www.liquidweb.com/for-agents/",
		"primary_page": "/",
		"canonical_source": "https://www.liquidweb.com",
		"locales": [
			"en-US"
		],
		"default_currency": "USD"
	}
}