{"files":{"SKILL.md":"---\nname: ip-geolocation-api\ndescription: \"IP Geolocation API skill. Use when working with IP Geolocation for data. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# IP Geolocation API\n\n## Auth\nApiKey key in query\n\n## Base URL\nhttps://api-bdc.net/data/ip-geolocation\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /data/ip-geolocation -- this api returns additional security hazard report in addition to confidence area and locality information\n3. Explore available endpoints below\n\n## Endpoints\n3 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Data\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /data/ip-geolocation | This API returns additional security hazard report in addition to confidence area and locality information |\n| GET | /data/ip-geolocation-with-confidence | Returns list of geocoordinates which represents estimated geolocation confidence area |\n| GET | /data/ip-geolocation-full | Returns list of geocoordinates which represents estimated geolocation confidence area |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all ip-geolocation?\" -> GET /data/ip-geolocation\n- \"List all ip-geolocation-with-confidence?\" -> GET /data/ip-geolocation-with-confidence\n- \"List all ip-geolocation-full?\" -> GET /data/ip-geolocation-full\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api IP Geolocation API\n@base https://api-bdc.net/data/ip-geolocation\n@auth ApiKey key in query\n@endpoints 3\n@toc data(3)\n\n@endpoint GET /data/ip-geolocation\n@desc This API returns additional security hazard report in addition to confidence area and locality information\n@optional {ip: str # IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed, localityLanguage: str # Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided, key: str # Your API key}\n@returns(200) {ip: str, localityLanguageRequested: str, isReachableGlobally: bool, country: map, location: map, lastUpdated: str, network: map, confidence: str, confidenceArea: [map], securityThreat: str, hazardReport: map}\n\n@endpoint GET /data/ip-geolocation-with-confidence\n@desc Returns list of geocoordinates which represents estimated geolocation confidence area\n@optional {ip: str # IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed, localityLanguage: str # Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided, key: str # Your API key}\n@returns(200) {ip: str, localityLanguageRequested: str, isReachableGlobally: bool, country: map, location: map, lastUpdated: str, network: map, confidence: str, confidenceArea: [map]}\n\n@endpoint GET /data/ip-geolocation-full\n@desc Returns list of geocoordinates which represents estimated geolocation confidence area\n@optional {ip: str # IPv4 IP address in a string or numeric format. If omitted, the caller’s IP address is assumed, localityLanguage: str # Preferred language for locality names in ISO 639-1 format, such as 'en' for English, 'es' for Spanish etc. Please note: 147 common world languages are supported, full list here, but not all languages are available for every location. If requested language is not available for a requested location it will default to English, if no English is available, the native, local names will be provided, key: str # Your API key}\n@returns(200) {ip: str, localityLanguageRequested: str, isReachableGlobally: bool, country: map, location: map, lastUpdated: str, network: map, confidence: str, confidenceArea: [map]}\n\n@end\n"}}