{"id":16537940,"url":"https://github.com/ddspringle/abuseipdb-cfml","last_synced_at":"2026-02-16T04:38:00.477Z","repository":{"id":73580122,"uuid":"77877292","full_name":"ddspringle/abuseipdb-CFML","owner":"ddspringle","description":"An API wrapper for AbuseIPDB.com's IP abuse database (https://abuseipdb.com/api.html) ","archived":false,"fork":false,"pushed_at":"2017-01-03T03:37:15.000Z","size":9,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-05T00:49:02.615Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"ColdFusion","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddspringle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-03T02:29:16.000Z","updated_at":"2020-10-21T17:50:08.000Z","dependencies_parsed_at":"2023-03-15T08:30:34.348Z","dependency_job_id":null,"html_url":"https://github.com/ddspringle/abuseipdb-CFML","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ddspringle/abuseipdb-CFML","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddspringle%2Fabuseipdb-CFML","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddspringle%2Fabuseipdb-CFML/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddspringle%2Fabuseipdb-CFML/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddspringle%2Fabuseipdb-CFML/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddspringle","download_url":"https://codeload.github.com/ddspringle/abuseipdb-CFML/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddspringle%2Fabuseipdb-CFML/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29500603,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T03:57:51.541Z","status":"ssl_error","status_checked_at":"2026-02-16T03:55:59.854Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T18:44:03.154Z","updated_at":"2026-02-16T04:38:00.461Z","avatar_url":"https://github.com/ddspringle.png","language":"ColdFusion","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AbuseIPDB CFML\nThis repository includes a CFC called abuseIPDBService.cfc that makes use of the AbuseIPDB blacklist API - this blacklist maintains the IP addresses that have been associated with malicious activity online.\n\n## Usage\n\nTo use this wrapper, simply initialize it with your API key provided by AbuseIPDB, as follows:\n\n    // get the abuseIPDBService\n    abuseIPDBService = createObject( 'component', 'abuseIPDBService').init( apiKey = '[API_KEY]' );\n\n### Check IP for abuse\n\nYou can call the service with the IP address you wish to check, as follows:\n\n    // get the structure as a variable from the httpBL service    \n\treturnStruct = abuseIPDBService.checkIP( ipAddress = [IP_ADDRESS] [, days = 30 ] );\n\nThe checkIp function returns either a struct if only one report exists within the days requested, an array of structs if more than one independant report and an empty array if there is no result. Structs will have the following keys:\n\n    ip: This simply reflects the ip address you requested\n    country: The name of the country where this IP is assigned\n    isoCode: The 2-letter ISO country code for the country\n    category: An array of integer category id's\n    created: The date and time of the report\n\nYou can pass an optional `days` argument to checkIp to set the number of days back to report on. The default is 30 days.\n\n### Report IP for abuse\n\nYou can also report the IP addresses that you have found performing malicious activity against your site to the blacklist, by passing in the IP address, a comma delimited list of category ints and your reason for taking local action against this IP address (e.g. 'performing SQL injection attempts') as follows:\n\n\t// report an ip address to the blacklist for abuse\n\treportStruct = abuseIPDBService.reportIP( \n\t\tipAddress = [IP address to report], \n\t\tcategoryList = [comma delim category ints],\n\t\tcomment = [Your reason for taking local action against the IP]\n\t);\n\nThe reportIP function returns a struct with success indication.\n\n### Get AbuseIPDB categories\n\nYou can also get an array of [categories](https://abuseipdb.com/categories) from this wrapper, as follows:\n\n\t// get array of abuse category structs\n\tabuseCatArray = abuseIPDBService.getAbuseCategories();\n\n\n**NOTE**: You should [read the abuseIPDB API documentation](https://abuseipdb.com/api.html) for more information about the API.\n\n## Compatibility\n\n* Adobe ColdFusion 11+\n* Lucee 4.5+\n\n## Bugs and Feature Requests\n\nIf you find any bugs or have a feature you'd like to see implemented in this code, please use the issues area here on GitHub to log them.\n\n## Contributing\n\nThis project is actively being maintained and monitored by Denard Springle. If you would like to contribute to this project please feel free to fork, modify and send a pull request!\n\n## License\n\nThe use and distribution terms for this software are covered by the Apache Software License 2.0 (http://www.apache.org/licenses/LICENSE-2.0).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddspringle%2Fabuseipdb-cfml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddspringle%2Fabuseipdb-cfml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddspringle%2Fabuseipdb-cfml/lists"}