{
  "openapi": "3.1.0",
  "info": {
    "title": "Vetrics Medicines API",
    "version": "1.0.0",
    "description": "Structured veterinary medicines authorised for use in Great Britain (VMD-derived). Free and rate-limited at launch."
  },
  "servers": [
    { "url": "https://api.medicines.vetrics.co" },
    { "url": "https://api.medicines.vetrics.co", "description": "/v1/* is an alias of /api/v1/*" }
  ],
  "paths": {
    "/v1/medicines": {
      "get": {
        "summary": "List medicines (alias of /api/v1/medicines)",
        "responses": { "200": { "description": "Paginated medicines" } }
      }
    },
    "/api/v1/medicines": {
      "get": {
        "summary": "List medicines (cursor pagination)",
        "parameters": [
          { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100 } },
          { "name": "cursor", "in": "query", "schema": { "type": "string" } },
          { "name": "status", "in": "query", "schema": { "type": "string" } },
          { "name": "species", "in": "query", "schema": { "type": "string" } },
          { "name": "substance", "in": "query", "schema": { "type": "string" } },
          { "name": "category", "in": "query", "schema": { "type": "string" } },
          { "name": "vmNumber", "in": "query", "schema": { "type": "string" } },
          { "name": "productName", "in": "query", "schema": { "type": "string" } },
          { "name": "maHolder", "in": "query", "schema": { "type": "string" } },
          { "name": "pharmaceuticalForm", "in": "query", "schema": { "type": "string" } }
        ],
        "responses": { "200": { "description": "Paginated medicines" } }
      }
    },
    "/api/v1/medicines/search": {
      "get": {
        "summary": "Search medicines",
        "parameters": [
          { "name": "q", "in": "query", "schema": { "type": "string", "minLength": 2 } }
        ],
        "responses": { "200": { "description": "Search results" } }
      }
    },
    "/api/v1/medicines/{id}": {
      "get": {
        "summary": "Medicine detail",
        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "Medicine record" }, "404": { "description": "Not found" } }
      }
    },
    "/api/v1/medicines/{id}/documents": {
      "get": {
        "summary": "Medicine documents",
        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "Document metadata" } }
      }
    },
    "/api/v1/medicines/{id}/spc": {
      "get": {
        "summary": "Published structured SPC (feature-flagged)",
        "parameters": [{ "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }],
        "responses": {
          "200": { "description": "Structured SPC with citations" },
          "404": { "description": "Not available or not published" }
        }
      }
    },
    "/api/v1/medicines/{id}/spc/{section}": {
      "get": {
        "summary": "One canonical SPC section",
        "parameters": [
          { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } },
          { "name": "section", "in": "path", "required": true, "schema": { "type": "string" } }
        ],
        "responses": {
          "200": { "description": "Section payload" },
          "404": { "description": "Not available" }
        }
      }
    },
    "/api/v1/substances": {
      "get": {
        "summary": "Substance lookup",
        "parameters": [{ "name": "q", "in": "query", "required": true, "schema": { "type": "string" } }],
        "responses": { "200": { "description": "Substances" } }
      }
    },
    "/api/v1/meta": {
      "get": {
        "summary": "Corpus metadata and attribution",
        "responses": { "200": { "description": "Meta" } }
      }
    }
  }
}