{
  "openapi": "3.1.0",
  "info": {
    "title": "NYC Legal Public AI Datasets",
    "version": "1.1.0",
    "description": "Read-only, CC-BY-4.0-licensed JSON datasets covering services, pricing, embassies, case studies, notaries, FAQ, HowTo procedures, glossary, locations, reviewers, and country coverage for NYC Legal & Notary Services Co., Ltd. (Thailand). For real-time tool calls, use the MCP server at /api/mcp instead.",
    "contact": {
      "name": "NYC Legal",
      "url": "https://nyclegal.co.th/contact",
      "email": "nyclegal@ilc.ltd"
    },
    "license": {
      "name": "CC-BY-4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    }
  },
  "servers": [
    {
      "url": "https://nyclegal.co.th",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "MCP server (real-time tools)",
    "url": "https://nyclegal.co.th/api/mcp"
  },
  "paths": {
    "/api/public/dataset": {
      "get": {
        "summary": "Discovery index of every public dataset endpoint.",
        "operationId": "dataset",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/organization": {
      "get": {
        "summary": "Schema.org LegalService knowledge graph.",
        "operationId": "dataset_organization",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/services": {
      "get": {
        "summary": "Flagship service catalog with pricing and turnaround.",
        "operationId": "dataset_services",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/case-studies": {
      "get": {
        "summary": "Anonymized client case studies.",
        "operationId": "dataset_case_studies",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/notaries": {
      "get": {
        "summary": "Licensed Notary Public attorney roster.",
        "operationId": "dataset_notaries",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/faq": {
      "get": {
        "summary": "FAQPage JSON-LD across all practice areas.",
        "operationId": "dataset_faq",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/howto": {
      "get": {
        "summary": "Step-by-step HowTo procedures (TH + EN).",
        "operationId": "dataset_howto",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/glossary": {
      "get": {
        "summary": "Bilingual Thai/English legal DefinedTermSet.",
        "operationId": "dataset_glossary",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/embassies": {
      "get": {
        "summary": "Embassy & consulate directory (169 entries).",
        "operationId": "dataset_embassies",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/locations": {
      "get": {
        "summary": "Branches, BKK districts, provincial agents with geo.",
        "operationId": "dataset_locations",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/pricing": {
      "get": {
        "summary": "Machine-readable price + turnaround matrix.",
        "operationId": "dataset_pricing",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/reviewers": {
      "get": {
        "summary": "Person + OccupationalCredential roster.",
        "operationId": "dataset_reviewers",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/api/public/dataset/coverage": {
      "get": {
        "summary": "168-country, 50-language coverage matrix.",
        "operationId": "dataset_coverage",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              },
              "application/ld+json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {}
  },
  "x-mcp": {
    "endpoint": "https://nyclegal.co.th/api/mcp",
    "transport": "Streamable HTTP (POST JSON-RPC 2.0)",
    "tools": [
      "list_services",
      "get_service_pricing",
      "get_embassy_requirements",
      "list_supported_countries",
      "search_case_studies",
      "list_attorneys",
      "get_contact_info",
      "search_faq",
      "lookup_glossary_term",
      "get_howto_steps",
      "find_nearest_branch",
      "list_news",
      "calculate_quote",
      "submit_lead",
      "request_quote",
      "book_appointment"
    ]
  }
}