{
  "name": "sthan",
  "description": "US address verification, parsing, autocomplete, forward/reverse geocoding, and IP geolocation APIs",
  "url": "https://api.sthan.io",
  "provider": {
    "organization": "sthan.io",
    "url": "https://sthan.io"
  },
  "version": "1.0.0",
  "documentationUrl": "https://sthan.io/docs",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "verify-us-address",
      "name": "Verify US Address",
      "description": "Verify a US address for deliverability. Returns standardized components, ZIP+4, DPV confirmation, and postal verification status.",
      "tags": ["address", "verification", "usa", "deliverability", "postal", "dpv"],
      "examples": [
        "Verify 123 Main St, New York, NY 10001",
        "Is this address valid: 456 Oak Ave, Los Angeles, CA 90001?",
        "Check if my customer address is deliverable"
      ]
    },
    {
      "id": "parse-us-address",
      "name": "Parse US Address",
      "description": "Parse a freeform US address string into structured components (street, city, state, zip, unit, etc.).",
      "tags": ["address", "parsing", "usa", "structured-data", "components"],
      "examples": [
        "Parse 'apt 2b 500 broadway new york ny 10012' into components",
        "Break down this address: 123 N Main St Ste 200 Chicago IL"
      ]
    },
    {
      "id": "autocomplete-us-address",
      "name": "Autocomplete US Address",
      "description": "Get address suggestions from partial input. Sub-100ms response time.",
      "tags": ["address", "autocomplete", "usa", "suggestions", "typeahead"],
      "examples": [
        "Suggest addresses starting with '123 Main'",
        "Complete this address: 456 Oak"
      ]
    },
    {
      "id": "geocode-us-address",
      "name": "Forward Geocode US Address",
      "description": "Convert a US address to latitude/longitude coordinates with accuracy classification.",
      "tags": ["geocoding", "coordinates", "usa", "latitude", "longitude", "mapping"],
      "examples": [
        "Get coordinates for 1600 Pennsylvania Ave, Washington DC",
        "What are the lat/long for the White House?",
        "Geocode this address for mapping"
      ]
    },
    {
      "id": "reverse-geocode",
      "name": "Reverse Geocode",
      "description": "Convert latitude/longitude coordinates to the nearest US street address with distance.",
      "tags": ["reverse-geocoding", "coordinates", "usa", "address-lookup"],
      "examples": [
        "What address is at 40.7128, -74.0060?",
        "Find the nearest address to coordinates 38.8977, -77.0365"
      ]
    },
    {
      "id": "ip-geolocation",
      "name": "IP Geolocation",
      "description": "Look up the geographic location of an IPv4 or IPv6 address. Returns country, region, city, coordinates, timezone.",
      "tags": ["ip", "geolocation", "location", "global", "ipv4", "ipv6"],
      "examples": [
        "Where is IP 8.8.8.8 located?",
        "Get the geolocation for this IP address"
      ]
    }
  ],
  "authentication": {
    "schemes": ["bearer"],
    "credentials": "Sign up at https://sthan.io and create an API key in your dashboard (https://sthan.io/dashboard). Send it as a Bearer token: 'Authorization: Bearer sthan_{environment}_{key}'. Legacy alternative: obtain a JWT from GET /Auth/Token with profileName and profilePassword headers (view those at https://sthan.io/apikeys)."
  },
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json"]
}