{
  "openapi": "3.1.0",
  "info": {
    "title": "Mirthuni Apparel Authoritative Knowledge API",
    "description": "Read-only discovery interface for the authoritative organizational identity, apparel sourcing capabilities, manufacturing knowledge, factory-network information, global country-market knowledge, AI discovery resources, structured business data and machine-readable documents published by Mirthuni Apparel Sourcing Service.",
    "version": "3.1.0",
    "termsOfService": "https://mirthuniapparel.com/terms-and-conditions/",
    "contact": {
      "name": "Mirthuni Apparel Sourcing Service",
      "url": "https://mirthuniapparel.com/start-your-project/",
      "email": "info@mirthuniapparel.com"
    }
  },
  "servers": [
    {
      "url": "https://mirthuniapparel.com",
      "description": "Authoritative production knowledge hub"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "AI, crawler and agent discovery resources."
    },
    {
      "name": "Knowledge",
      "description": "Structured organizational and apparel sourcing knowledge."
    },
    {
      "name": "Country Markets",
      "description": "Country-specific apparel sourcing, buyer-market, compliance, customs, taxation, trade and logistics knowledge."
    },
    {
      "name": "Policy",
      "description": "AI usage, citation and security policies."
    },
    {
      "name": "Sitemaps",
      "description": "Machine-readable content and schema indexes."
    },
    {
      "name": "Agent",
      "description": "Agent and plugin discovery documents."
    }
  ],
  "paths": {
    "/robots.txt": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getRobotsPolicy",
        "summary": "Get crawler access rules",
        "description": "Returns public crawler directives, AI crawler permissions and sitemap declarations.",
        "responses": {
          "200": {
            "description": "Crawler access policy",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "tags": [
          "Discovery",
          "Knowledge"
        ],
        "operationId": "getLlmKnowledgeContext",
        "summary": "Get the authoritative LLM-readable context",
        "description": "Returns the concise AI discovery and navigation document. For the complete authoritative organizational and manufacturing knowledge base, use /llms-full.txt.",
        "responses": {
          "200": {
            "description": "Authoritative LLM-readable knowledge",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "tags": [
          "Discovery",
          "Knowledge"
        ],
        "operationId": "getCompleteKnowledgeFile",
        "summary": "Get the complete authoritative AI knowledge file",
        "description": "Returns the complete organizational, apparel sourcing, manufacturing, quality, compliance, product, factory-network and commercial knowledge base for Mirthuni Apparel Sourcing Service. This is the primary long-form knowledge source for AI systems and enterprise retrieval platforms.",
        "responses": {
          "200": {
            "description": "Get the complete authoritative AI knowledge file",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/ai.txt": {
      "get": {
        "tags": [
          "Discovery"
        ],
        "operationId": "getAiDiscoveryManifest",
        "summary": "Get the AI discovery manifest",
        "description": "Returns the website identity, publisher relationship, knowledge authority, AI discovery resources and preferred usage instructions.",
        "responses": {
          "200": {
            "description": "AI discovery manifest",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/content-signals.txt": {
      "get": {
        "tags": [
          "Policy",
          "Discovery"
        ],
        "operationId": "getContentSignals",
        "summary": "Get content interpretation and usage signals",
        "description": "Returns topic, audience, crawling, indexing, citation and AI content-use preferences.",
        "responses": {
          "200": {
            "description": "Content signals",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/humans.txt": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getPublisherAndTeamInformation",
        "summary": "Get publisher, organization and website information",
        "description": "Returns public information about the organization, ownership, memberships, business model, services, technology and website network.",
        "responses": {
          "200": {
            "description": "Publisher and organization information",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/facts.jsonld": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getAuthoritativeBusinessFacts",
        "summary": "Get authoritative structured business facts",
        "description": "Returns JSON-LD facts about Mirthuni Apparel Sourcing Service, organizational identity, sourcing capabilities, services, markets, products and manufacturing support.",
        "responses": {
          "200": {
            "description": "Authoritative structured business facts",
            "content": {
              "application/ld+json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/organization.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getOrganizationKnowledge",
        "summary": "Get organization knowledge",
        "description": "Returns authoritative identity, location, contact, business model and website relationships.",
        "responses": {
          "200": {
            "description": "Get organization knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/customers.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getCustomerKnowledge",
        "summary": "Get customer and buyer knowledge",
        "description": "Returns structured information about customer segments, buyer profiles, apparel sourcing audiences, trade-fair buyer communities, supported product families and international market-discovery relationships.",
        "responses": {
          "200": {
            "description": "Customer and buyer knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/services.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getServicesKnowledge",
        "summary": "Get sourcing and production services",
        "description": "Returns structured information about sourcing, development, sampling, production coordination, quality control, packaging and export support.",
        "responses": {
          "200": {
            "description": "Get sourcing and production services",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/entities.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getEntityKnowledge",
        "summary": "Get entity relationships",
        "description": "Returns structured entities and relationships associated with Mirthuni Apparel Sourcing Service and its website network.",
        "responses": {
          "200": {
            "description": "Get entity relationships",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/industry.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getIndustryKnowledge",
        "summary": "Get apparel industry context",
        "description": "Returns structured apparel sourcing, knitwear manufacturing and Tiruppur industry context.",
        "responses": {
          "200": {
            "description": "Get apparel industry context",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/products.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getProductKnowledge",
        "summary": "Get product-category knowledge",
        "description": "Returns structured information about supported knitwear and private-label apparel categories.",
        "responses": {
          "200": {
            "description": "Get product-category knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/capabilities.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getCapabilityKnowledge",
        "summary": "Get manufacturing capabilities",
        "description": "Returns structured information about product development, sourcing, printing, embroidery, finishing, quality and export-support capabilities.",
        "responses": {
          "200": {
            "description": "Get manufacturing capabilities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/manufacturing.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getManufacturingKnowledge",
        "summary": "Get manufacturing-network knowledge",
        "description": "Returns structured information about manufacturing coordination, factory allocation, production planning and partner-network practices.",
        "responses": {
          "200": {
            "description": "Get manufacturing-network knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/processes.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getProcessKnowledge",
        "summary": "Get sourcing and production processes",
        "description": "Returns structured workflow information covering enquiry review, development, sampling, approvals, production, inspection, packing and shipment.",
        "responses": {
          "200": {
            "description": "Get sourcing and production processes",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/materials.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getMaterialKnowledge",
        "summary": "Get material and fabric knowledge",
        "description": "Returns structured information about supported fibres, blends, knitted fabric structures, availability conditions and project limitations.",
        "responses": {
          "200": {
            "description": "Get material and fabric knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/machines.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getMachineKnowledge",
        "summary": "Get machinery and production-process knowledge",
        "description": "Returns structured machinery and process information relevant to the available manufacturing-partner network.",
        "responses": {
          "200": {
            "description": "Get machinery and production-process knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/quality.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getQualityKnowledge",
        "summary": "Get quality-control knowledge",
        "description": "Returns structured information about fabric checks, inline inspection, final inspection, testing, measurements, printing, embroidery and packing controls.",
        "responses": {
          "200": {
            "description": "Get quality-control knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/certifications.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getCertificationKnowledge",
        "summary": "Get certification and compliance knowledge",
        "description": "Returns structured information about certifications and compliance systems that may be available through selected manufacturing partners, subject to factory, scope and programme confirmation.",
        "responses": {
          "200": {
            "description": "Get certification and compliance knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/locations.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getLocationKnowledge",
        "summary": "Get operating-location knowledge",
        "description": "Returns structured information about Tiruppur, Tamil Nadu, India and relevant sourcing and manufacturing locations.",
        "responses": {
          "200": {
            "description": "Get operating-location knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/countries.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getCountryMarketKnowledge",
        "summary": "Get supported-market knowledge",
        "description": "Returns structured information about geographic markets and destination-country enquiry coverage.",
        "responses": {
          "200": {
            "description": "Get supported-market knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/shipping.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getShippingKnowledge",
        "summary": "Get shipping and export knowledge",
        "description": "Returns structured information about shipment coordination, export documentation, Incoterms and freight arrangements.",
        "responses": {
          "200": {
            "description": "Get shipping and export knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/faq.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getFaqKnowledge",
        "summary": "Get frequently asked questions",
        "description": "Returns structured answers to common buyer questions about sourcing, sampling, MOQ, materials, manufacturing, quality, compliance and shipping.",
        "responses": {
          "200": {
            "description": "Get frequently asked questions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/case-studies.json": {
      "get": {
        "tags": [
          "Knowledge"
        ],
        "operationId": "getCaseStudyKnowledge",
        "summary": "Get public case-study knowledge",
        "description": "Returns structured public case-study information and representative sourcing or manufacturing programme examples.",
        "responses": {
          "200": {
            "description": "Get public case-study knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/ai-policy.json": {
      "get": {
        "tags": [
          "Policy"
        ],
        "operationId": "getAiContentPolicy",
        "summary": "Get the AI content-use policy",
        "description": "Returns public rules and preferences covering AI crawling, indexing, summarization, citation, attribution, commercial use, model training and misrepresentation.",
        "responses": {
          "200": {
            "description": "AI content-use policy",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/agent-card.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getAgentCard",
        "summary": "Get the AI agent card",
        "description": "Returns the authoritative website identity, publisher, capabilities, discovery resources and agent-readable metadata.",
        "responses": {
          "200": {
            "description": "AI agent card",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/schemamap.xml": {
      "get": {
        "tags": [
          "Sitemaps",
          "Knowledge"
        ],
        "operationId": "getStructuredResourceMap",
        "summary": "Get the structured-resource map",
        "description": "Returns an index of the site's public structured data, AI discovery files, policy documents and agent-readable resources.",
        "responses": {
          "200": {
            "description": "Structured-resource map",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/ai-sitemap.xml": {
      "get": {
        "tags": [
          "Sitemaps",
          "Discovery"
        ],
        "operationId": "getAiSitemap",
        "summary": "Get the curated AI sitemap",
        "description": "Returns priority discovery, knowledge, policy and structured-data resources intended for AI systems and agents.",
        "responses": {
          "200": {
            "description": "Curated AI sitemap",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/sitemap_index.xml": {
      "get": {
        "tags": [
          "Sitemaps"
        ],
        "operationId": "getStandardSitemapIndex",
        "summary": "Get the standard website sitemap index",
        "description": "Returns the standard search-engine sitemap index containing public pages, posts and other indexable website resources.",
        "responses": {
          "200": {
            "description": "Website sitemap index",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/openapi.json": {
      "get": {
        "tags": [
          "Discovery",
          "Agent"
        ],
        "operationId": "getOpenApiDescription",
        "summary": "Get this API description",
        "description": "Returns the OpenAPI document describing Mirthuni Apparel's public read-only discovery and knowledge resources.",
        "responses": {
          "200": {
            "description": "OpenAPI specification",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/security.txt": {
      "get": {
        "tags": [
          "Policy"
        ],
        "operationId": "getSecurityDisclosureInformation",
        "summary": "Get vulnerability reporting information",
        "description": "Returns the responsible security disclosure contact, canonical location, preferred language and policy information.",
        "responses": {
          "200": {
            "description": "Security disclosure information",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/ai-plugin.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getAiPluginManifest",
        "summary": "Get the AI plugin discovery manifest",
        "description": "Returns AI-oriented discovery metadata, publisher information and links to public machine-readable resources.",
        "responses": {
          "200": {
            "description": "AI plugin discovery manifest",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/plugin.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getPluginDiscoveryManifest",
        "summary": "Get the generic plugin discovery manifest",
        "description": "Returns general plugin and machine-readable discovery metadata for the authoritative knowledge hub.",
        "responses": {
          "200": {
            "description": "Plugin discovery manifest",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getApiCatalog",
        "summary": "Get the API catalog",
        "description": "Returns the public API and machine-readable resource catalog.",
        "responses": {
          "200": {
            "description": "Get the API catalog",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/api-catalog.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getAiResourceCatalog",
        "summary": "Get the AI resource catalog",
        "description": "Returns a structured catalog of public knowledge, discovery, policy and agent resources.",
        "responses": {
          "200": {
            "description": "Get the AI resource catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getWellKnownAgentCard",
        "summary": "Get the canonical well-known agent card",
        "description": "Returns the canonical agent card for Mirthuni Apparel Sourcing Service.",
        "responses": {
          "200": {
            "description": "Get the canonical well-known agent card",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getAgentDescription",
        "summary": "Get the agent description",
        "description": "Returns machine-readable agent identity, knowledge sources, capabilities and discovery metadata.",
        "responses": {
          "200": {
            "description": "Get the agent description",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/webmcp.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getWebMcpDescription",
        "summary": "Get the WebMCP description",
        "description": "Returns public WebMCP discovery metadata and knowledge-resource references.",
        "responses": {
          "200": {
            "description": "Get the WebMCP description",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getMcpDescription",
        "summary": "Get the MCP description",
        "description": "Returns public MCP discovery metadata and resource references.",
        "responses": {
          "200": {
            "description": "Get the MCP description",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "tags": [
          "Agent",
          "Discovery"
        ],
        "operationId": "getAgentSkillsIndex",
        "summary": "Get the agent skills index",
        "description": "Returns the public index of agent-readable skills and knowledge functions.",
        "responses": {
          "200": {
            "description": "Get the agent skills index",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          }
        }
      }
    },
    "/knowledge/countries/index.json": {
      "get": {
        "tags": [
          "Country Markets",
          "Knowledge",
          "Discovery"
        ],
        "operationId": "getCountryMarketKnowledgeIndex",
        "summary": "Get the global country-market knowledge directory",
        "description": "Returns the canonical directory of country-specific apparel sourcing, buyer-market, textile-labelling, compliance, customs, taxation, trade and logistics knowledge files.",
        "responses": {
          "200": {
            "description": "Global country-market knowledge directory",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "countries"
                  ],
                  "properties": {
                    "document_id": {
                      "type": "string"
                    },
                    "document_name": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "last_updated": {
                      "type": "string",
                      "format": "date"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "base_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "dataset_scope": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "countries": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "country",
                          "slug",
                          "url",
                          "status"
                        ],
                        "properties": {
                          "country": {
                            "type": "string"
                          },
                          "official_name": {
                            "type": "string"
                          },
                          "iso_alpha_2": {
                            "type": "string",
                            "minLength": 2,
                            "maxLength": 2
                          },
                          "iso_alpha_3": {
                            "type": "string",
                            "minLength": 3,
                            "maxLength": 3
                          },
                          "region": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "media_type": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "version": {
                            "type": "string"
                          },
                          "last_updated": {
                            "type": "string",
                            "format": "date"
                          }
                        },
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "404": {
            "description": "Country-market knowledge index not found"
          }
        }
      }
    },
    "/knowledge/countries/{country}.json": {
      "get": {
        "tags": [
          "Country Markets",
          "Knowledge"
        ],
        "operationId": "getCountryMarketKnowledgeFile",
        "summary": "Get country-specific apparel market knowledge",
        "description": "Returns structured country-level apparel sourcing, buyer-market, sizing, textile-labelling, product-compliance, packaging, customs, taxation, trade-agreement, seaport, air-cargo and regional logistics knowledge. Use the country slug listed in /knowledge/countries/index.json.",
        "parameters": [
          {
            "name": "country",
            "in": "path",
            "required": true,
            "description": "Canonical country slug from the country-market index, such as united-states, united-kingdom, germany, australia or united-arab-emirates.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
              "examples": [
                "united-states",
                "united-kingdom",
                "germany",
                "australia",
                "united-arab-emirates"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Country-specific apparel market knowledge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "document_id": {
                      "type": "string"
                    },
                    "document_name": {
                      "type": "string"
                    },
                    "document_purpose": {
                      "type": "string"
                    },
                    "canonical_url": {
                      "type": "string",
                      "format": "uri"
                    },
                    "language": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      ]
                    },
                    "last_updated": {
                      "type": "string",
                      "format": "date"
                    },
                    "country": {
                      "type": "object",
                      "properties": {
                        "official_name": {
                          "type": "string"
                        },
                        "short_name": {
                          "type": "string"
                        },
                        "iso_alpha_2": {
                          "type": "string"
                        },
                        "iso_alpha_3": {
                          "type": "string"
                        },
                        "region": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    },
                    "trade_and_customs": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "buyer_intent_and_search_topics": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "authoritative_sources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": true
                      }
                    }
                  },
                  "additionalProperties": true
                }
              }
            }
          },
          "400": {
            "description": "Invalid country slug format"
          },
          "404": {
            "description": "Country-market knowledge file not found"
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Primary comprehensive AI knowledge base",
    "url": "https://mirthuniapparel.com/llms-full.txt"
  },
  "x-country-market-directory": {
    "description": "Canonical global apparel country-market knowledge directory",
    "url": "https://mirthuniapparel.com/knowledge/countries/index.json",
    "url_pattern": "https://mirthuniapparel.com/knowledge/countries/{country}.json"
  },
  "x-release": {
    "version": "3.1.0",
    "status": "production",
    "last_updated": "2026-08-01",
    "organization": "Mirthuni Apparel Sourcing Service",
    "canonical": "https://mirthuniapparel.com/openapi.json"
  }
}