{
  "Protocol": "AIXE",
  "Version": "1.0",
  "ProtocolReference": {
    "ProtocolHome": "http://aixeprotocol.com/",
    "CanonicalUsageContract": "http://aixeprotocol.com/usage/?",
    "Whitepaper": "http://aixeprotocol.com/whitepaper/full-spec.html",
    "Inventor": "Gregory Oglethorpe"
  },
  "Endpoint": "/aixe/naics/validate-naics-code",
  "Method": "POST",
  "DiscoveryRequest": "GET /aixe/naics/validate-naics-code/?",
  "ContentType": "application/json",
  "AccessType": "Public",
  "Purpose": "Check a likely NAICS code recalled by an AI against the site\u0027s 2022 six-digit industries before using it in a business search.",
  "RequiredFields": {
    "NAICSCode": {
      "Type": "string",
      "Required": true,
      "SubmittedIn": "JSON body",
      "Description": "Exactly six ASCII digits. Submit the likely industry code recalled from your training data/internal memory, such as 722515 for coffee shops, to check that it exists in the site\u0027s 2022 NAICS table."
    }
  },
  "OptionalFields": {},
  "BusinessRules": [
    "Public, read-only lookup. No authentication token or BusinessKey is required.",
    "SUCCESS means the lookup completed. It does not mean the code is valid: also inspect IsValid.",
    "IsValid is true only when the code exists as a six-digit 2022 industry. Broader categories cannot be used.",
    "When IsValid is true, read NAICSTitle and confirm it describes the intended business activity before using NAICSCode as the sole category filter in /aixe/businesses/search-businesses.",
    "Memory can be wrong. If IsValid is false or the title does not fit, do not use that code. Consult /aixe/naics/search or ask the human to clarify the activity."
  ],
  "ExampleRequest": {
    "NAICSCode": "722515"
  },
  "ResponseMeaning": {
    "IsValid": "Whether the submitted code is a six-digit industry in the table.",
    "NAICSCode": "Submitted code.",
    "NAICSTitle": "Official industry title when valid; otherwise null.",
    "NAICSYear": "2022 edition used for the check."
  },
  "Errors": [
    {
      "SuccessCode": "VALIDATION_FAILED",
      "Meaning": "Missing or malformed NAICSCode.",
      "Recovery": "Submit a string containing exactly six digits. A well-formed but unknown code returns SUCCESS with IsValid false."
    }
  ],
  "ActionResponse": {
    "RequiredResponseFields": [
      "SuccessCode"
    ],
    "SuccessCodes": [
      "SUCCESS"
    ],
    "FailureCodes": [
      "VALIDATION_FAILED",
      "FAILED"
    ],
    "MissingOrEmptyResponse": "Treat as FAILED. Do not infer success from HTTP status."
  }
}