API Enumeration & Discovery
When to Use
- When initiating a web application pentest or bug bounty. You must find the APIs powering the frontend React/Vue apps.
- When searching for "Shadow APIs" (old
v1/ endpoints developers forgot to turn off).
- When seeking undocumented parameters (e.g., hidden
?admin=true queries) on known endpoints.
- When trying to locate API documentation exposed accidentally (Swagger/OpenAPI).
Prerequisites
- Authorized scope and target URLs from bug bounty program
- Burp Suite Professional (or Community) configured with browser proxy
- Familiarity with OWASP Top 10 and common web vulnerability classes
- SecLists wordlists for fuzzing and enumeration
Workflow
Phase 1: Passive Reconnaissance (API Spying)
# Concept: Watch the application talk to itself. Modern Single Page Applications (SPAs)
# constantly make XHR/AJAX requests to internal APIs.
# 1. Burp Suite Proxy History
# Browse the target site normally for 5 minutes. Filter Burp history for `/api/`.
# Document paths like: `api.target.com/v2/users/123/profile`
# 2. JavaScript Source Analysis (Crucial)
# Search the frontend webpack bundles for hidden API routes.
# Tool: x8 (or manually using Burp mapping)
cat subdomains.txt | waybackurls | grep "\.js" | xargs -n1 curl -s | grep -oE "api\/[a-zA-Z0-9\/_-]+"
Phase 2: Active Endpoint Brute-Forcing (Fuzzing)
# Concept: Guess standard, unlinked API endpoints utilizing massive wordlists.
# 1. Brute-force directories with FFUF (using seclists/Discovery/Web-Content/api)
ffuf -w Web-Content/api/api-endpoints.txt -u https://api.target.com/v1/FUZZ -mc 200,401,403
# 2. Advanced Kiterunner Exploitation
# Kiterunner is purpose-built for API discovery, using datasets of actual Swagger routes instead of generic words.
kr scan https://api.target.com -w routes-large.kite
# 3. Find Version Downgrades (Shadow APIs)
# If `/v3/users` is secure, check `/v1/users` or `/v2/users`. Older APIs often lack modern authentication.
Phase 3: Hunting for API Documentation (Swagger/OpenAPI)
# Concept: Developers on Swagger/OpenAPI to document endpoints.
# They frequently forget to disable this in production exposing the entire attack surface.
# Fuzz for common documentation paths using FFUF:
ffuf -w swagger-wordlist.txt -u https://api.target.com/FUZZ
# Common hits:
# /api/docs
# /api/swagger/v1/swagger.json
# /openapi.yaml
# /graphql (GraphQL endpoints often support introspection, returning the whole schema)
# Action: If you find `swagger.json`, import it directly into Postman or Burp Suite.
# You now have the exact required parameters, headers, and methods for EVERY endpoint.
Phase 4: Parameter & Method Fuzzing
# Concept: Identifying endpoints is half the battle. You must find undocumented "Hidden"
# variables that trigger administrative functions.
# Endpoint identified: POST /api/v1/user/update
# Normal param: {"email": "user@test.com"}
# 1. Parameter Fuzzing via FFUF or Arjun
Arjun -u https://api.target.com/api/v1/user/update -m GET
# Result: Arjun found hidden parameter `is_admin`.
# 2. Method Fuzzing (Restful Abuse)
# If a GET requests the user, test what a PUT or DELETE does.
# A developer might leave a `DELETE /api/v1/users/500` active without authentication.
# 3. Content-Type Smuggling
# Send JSON to an endpoint expecting XML, or XML to one expecting JSON. The parser might crash, revealing stack traces.
Decision Point 🔀
flowchart TD
A[Discover API Subdomain] --> B[Fuzz for Swagger/OpenAPI Docs]
B -->|Found docs| C[Import to Postman. Map endpoints.]
B -->|No Docs| D[Fuzz with Kiterunner/FFUF]
D --> E{Identify working endpoints?}
E -->|Yes| F[Method Fuzzing: GET/POST/PUT/DELETE]
F --> G[Parameter Fuzzing: Search for ?admin=true or ?role=dev]
E -->|No| H[Analyze frontend JS bundles for hardcoded routes]
🔵 Blue Team Detection & Defense
- API Gateways: Route all API traffic through centralized API Gateways (e.g., AWS API Gateway, Kong) enforcing strict rate limiting (defending against Kiterunner/FFUF brute-forcing).
- Disable Swagger in Production: Explicitly configure CI/CD pipelines to strip
/docs and swagger.json generation endpoints from production environment builds.
- Decommission Shadow APIs: Ruthlessly mandate end-of-life dates for
v1/ and v2/ APIs. Leaving heavily deprecated APIs accessible exposes systems to legacy logic flaws.
Key Concepts
| Concept |
Description |
| Shadow API |
An older, abandoned, or undocumented API endpoint that remains active on the server, often lacking modern security patches |
| Fuzzing |
Automating the injection of massive amounts of invalid or unexpected data into an application to discover mapping or provoke a crash |
| Swagger/OpenAPI |
A standard format (JSON or YAML) describing a REST API, mapping out all available endpoints, acceptable parameters, and expected responses |
Output Format
Bug Bounty Report: Undocumented Shadow API exposure
===================================================
Vulnerability: Information Disclosure (API Documentation)
Severity: Medium (CVSS 5.3)
Target: GET /api/v1/swagger.json
Description:
The production API environment exposes its complete OpenAPI/Swagger JSON specification at `/api/v1/swagger.json`. This document provides a highly structured, comprehensive map of the entire API attack surface, including previously undocumented internal administration endpoints (e.g., `/api/v1/internal/admin/flush_cache`).
Reproduction Steps:
1. Navigate to `https://api.target.com/api/v1/swagger.json`.
2. Observe the download of the 450kb JSON specification.
3. Import this JSON into Postman.
4. The attacker now possesses exact queries and necessary parameter structures to exploit the 50 mapped backend endpoints.
Impact:
While not a direct exploit, this represents critical Information Disclosure that drastically accelerates an attacker's ability to discover High and Critical severity logical flaws such as Mass Assignment or BOLA.
💰 Industry Bounty Payout Statistics (2024-2025)
| Company/Platform |
Total Paid |
Highest Single |
Year |
| Google VRP |
$17.1M |
$250,000 (CVE-2025-4609 Chrome sandbox escape) |
2025 |
| Microsoft |
$16.6M |
(Not disclosed) |
2024 |
| Google VRP |
$11.8M |
$100,115 (Chrome MiraclePtr Bypass) |
2024 |
| HackerOne (all programs) |
$81M |
$100,050 (crypto firm) |
2025 |
| Meta/Facebook |
$2.3M |
up to $300K (mobile code execution) |
2024 |
| Crypto.com (HackerOne) |
$2M program |
$2M max |
2024 |
| 1Password (Bugcrowd) |
$1M max |
$1M (highest Bugcrowd ever) |
2024 |
| Samsung |
$1M max |
$1M (critical mobile flaws) |
2025 |
Key Takeaway: Google alone paid $17.1M in 2025 — a 40% increase YoY. Microsoft paid $16.6M.
The industry is paying more, not less. Average critical bounty on HackerOne: $3,700 (2023).
📚 Shared Resources
For cross-cutting methodology applicable to all vulnerability classes, see:
References
1---2name: api-enumeration-fuzzing-discovery3description: >4 Systematically discover hidden Application Programming Interfaces (APIs), uncover undocumented5 endpoints (Shadow APIs), and fuzz parameters. Use this skill as the pivotal first step in6 API Bug Hunting, transforming a basic frontend application into a vast mapped attack surface.7domain: cybersecurity8subdomain: bug-hunting9category: API Security10difficulty: intermediate11estimated_time: "2-4 hours"12mitre_attack:13 tactics: [TA0001, TA0007]14 techniques: [T1595.002, T1595.003]15platforms: [linux, windows]16tags: [api-security, bug-hunting, discovery, ffuf, swagger, graphql, fuzzing]17tools: [ffuf, kiterunner, postman, burpsuite]18version: "1.0"19author: CyberSkills-Elite20license: Apache-2.021metadata:22 source: https://skillmd.com/skills/shulkwisec/api-enumeration-fuzzing-discovery23---2425# API Enumeration & Discovery2627## When to Use28- When initiating a web application pentest or bug bounty. You must find the APIs powering the frontend React/Vue apps.29- When searching for "Shadow APIs" (old `v1/` endpoints developers forgot to turn off).30- When seeking undocumented parameters (e.g., hidden `?admin=true` queries) on known endpoints.31- When trying to locate API documentation exposed accidentally (Swagger/OpenAPI).323334## Prerequisites35- Authorized scope and target URLs from bug bounty program36- Burp Suite Professional (or Community) configured with browser proxy37- Familiarity with OWASP Top 10 and common web vulnerability classes38- SecLists wordlists for fuzzing and enumeration3940## Workflow4142### Phase 1: Passive Reconnaissance (API Spying)4344```bash45# Concept: Watch the application talk to itself. Modern Single Page Applications (SPAs)46# constantly make XHR/AJAX requests to internal APIs.4748# 1. Burp Suite Proxy History49# Browse the target site normally for 5 minutes. Filter Burp history for `/api/`.50# Document paths like: `api.target.com/v2/users/123/profile`5152# 2. JavaScript Source Analysis (Crucial)53# Search the frontend webpack bundles for hidden API routes.54# Tool: x8 (or manually using Burp mapping)55cat subdomains.txt | waybackurls | grep "\.js" | xargs -n1 curl -s | grep -oE "api\/[a-zA-Z0-9\/_-]+"56```5758### Phase 2: Active Endpoint Brute-Forcing (Fuzzing)5960```bash61# Concept: Guess standard, unlinked API endpoints utilizing massive wordlists.6263# 1. Brute-force directories with FFUF (using seclists/Discovery/Web-Content/api)64ffuf -w Web-Content/api/api-endpoints.txt -u https://api.target.com/v1/FUZZ -mc 200,401,4036566# 2. Advanced Kiterunner Exploitation67# Kiterunner is purpose-built for API discovery, using datasets of actual Swagger routes instead of generic words.68kr scan https://api.target.com -w routes-large.kite6970# 3. Find Version Downgrades (Shadow APIs)71# If `/v3/users` is secure, check `/v1/users` or `/v2/users`. Older APIs often lack modern authentication.72```7374### Phase 3: Hunting for API Documentation (Swagger/OpenAPI)7576```bash77# Concept: Developers on Swagger/OpenAPI to document endpoints. 78# They frequently forget to disable this in production exposing the entire attack surface.7980# Fuzz for common documentation paths using FFUF:81ffuf -w swagger-wordlist.txt -u https://api.target.com/FUZZ82# Common hits:83# /api/docs84# /api/swagger/v1/swagger.json85# /openapi.yaml86# /graphql (GraphQL endpoints often support introspection, returning the whole schema)8788# Action: If you find `swagger.json`, import it directly into Postman or Burp Suite.89# You now have the exact required parameters, headers, and methods for EVERY endpoint.90```9192### Phase 4: Parameter & Method Fuzzing9394```bash95# Concept: Identifying endpoints is half the battle. You must find undocumented "Hidden" 96# variables that trigger administrative functions.9798# Endpoint identified: POST /api/v1/user/update99# Normal param: {"email": "user@test.com"}100101# 1. Parameter Fuzzing via FFUF or Arjun102Arjun -u https://api.target.com/api/v1/user/update -m GET103# Result: Arjun found hidden parameter `is_admin`.104105# 2. Method Fuzzing (Restful Abuse)106# If a GET requests the user, test what a PUT or DELETE does.107# A developer might leave a `DELETE /api/v1/users/500` active without authentication.108109# 3. Content-Type Smuggling110# Send JSON to an endpoint expecting XML, or XML to one expecting JSON. The parser might crash, revealing stack traces.111```112113#### Decision Point 🔀114```mermaid115flowchart TD116 A[Discover API Subdomain] --> B[Fuzz for Swagger/OpenAPI Docs]117 B -->|Found docs| C[Import to Postman. Map endpoints.]118 B -->|No Docs| D[Fuzz with Kiterunner/FFUF]119 D --> E{Identify working endpoints?}120 E -->|Yes| F[Method Fuzzing: GET/POST/PUT/DELETE]121 F --> G[Parameter Fuzzing: Search for ?admin=true or ?role=dev]122 E -->|No| H[Analyze frontend JS bundles for hardcoded routes]123```124125126## 🔵 Blue Team Detection & Defense127- **API Gateways**: Route all API traffic through centralized API Gateways (e.g., AWS API Gateway, Kong) enforcing strict rate limiting (defending against Kiterunner/FFUF brute-forcing).128- **Disable Swagger in Production**: Explicitly configure CI/CD pipelines to strip `/docs` and `swagger.json` generation endpoints from production environment builds.129- **Decommission Shadow APIs**: Ruthlessly mandate end-of-life dates for `v1/` and `v2/` APIs. Leaving heavily deprecated APIs accessible exposes systems to legacy logic flaws.130131## Key Concepts132| Concept | Description |133|---------|-------------|134| Shadow API | An older, abandoned, or undocumented API endpoint that remains active on the server, often lacking modern security patches |135| Fuzzing | Automating the injection of massive amounts of invalid or unexpected data into an application to discover mapping or provoke a crash |136| Swagger/OpenAPI | A standard format (JSON or YAML) describing a REST API, mapping out all available endpoints, acceptable parameters, and expected responses |137138## Output Format139```140Bug Bounty Report: Undocumented Shadow API exposure141===================================================142Vulnerability: Information Disclosure (API Documentation)143Severity: Medium (CVSS 5.3)144Target: GET /api/v1/swagger.json145146Description:147The production API environment exposes its complete OpenAPI/Swagger JSON specification at `/api/v1/swagger.json`. This document provides a highly structured, comprehensive map of the entire API attack surface, including previously undocumented internal administration endpoints (e.g., `/api/v1/internal/admin/flush_cache`).148149Reproduction Steps:1501. Navigate to `https://api.target.com/api/v1/swagger.json`.1512. Observe the download of the 450kb JSON specification.1523. Import this JSON into Postman.1534. The attacker now possesses exact queries and necessary parameter structures to exploit the 50 mapped backend endpoints.154155Impact:156While not a direct exploit, this represents critical Information Disclosure that drastically accelerates an attacker's ability to discover High and Critical severity logical flaws such as Mass Assignment or BOLA.157```158159160## 💰 Industry Bounty Payout Statistics (2024-2025)161162| Company/Platform | Total Paid | Highest Single | Year |163|-----------------|------------|---------------|------|164| **Google VRP** | $17.1M | $250,000 (CVE-2025-4609 Chrome sandbox escape) | 2025 |165| **Microsoft** | $16.6M | (Not disclosed) | 2024 |166| **Google VRP** | $11.8M | $100,115 (Chrome MiraclePtr Bypass) | 2024 |167| **HackerOne (all programs)** | $81M | $100,050 (crypto firm) | 2025 |168| **Meta/Facebook** | $2.3M | up to $300K (mobile code execution) | 2024 |169| **Crypto.com (HackerOne)** | $2M program | $2M max | 2024 |170| **1Password (Bugcrowd)** | $1M max | $1M (highest Bugcrowd ever) | 2024 |171| **Samsung** | $1M max | $1M (critical mobile flaws) | 2025 |172173**Key Takeaway**: Google alone paid $17.1M in 2025 — a 40% increase YoY. Microsoft paid $16.6M.174The industry is paying more, not less. Average critical bounty on HackerOne: $3,700 (2023).175176177## 📚 Shared Resources178> For cross-cutting methodology applicable to all vulnerability classes, see:179> - [`_shared/references/elite-chaining-strategy.md`](../_shared/references/elite-chaining-strategy.md) — Exploit chaining methodology and high-payout chain patterns180> - [`_shared/references/elite-report-writing.md`](../_shared/references/elite-report-writing.md) — HackerOne-optimized report writing, CWE quick reference181> - [`_shared/references/real-world-bounties.md`](../_shared/references/real-world-bounties.md) — Verified disclosed bounties by vulnerability class182183## References184- OWASP: [API Security Top 10 - API9: Improper Inventory Management](https://owasp.org/API-Security/editions/2023/en/0x11-i9-improper-inventory-management/)185- Kiterunner: [Contextual API Discovery](https://github.com/assetnote/kiterunner)186- Arjun: [HTTP Parameter Discovery Suite](https://github.com/s0md3v/Arjun)