Skip to main content

API Version Detection

developer
GET/v1/domain/api-version

Analyzes how an API implements versioning. Detects URL path versioning and header-based versioning, and discovers available API versions.

What It Does

Tests common URL path versioning patterns (/v1/, /v2/, /api/v1/, /api/v2/) with parallel batch probing. Validates responses by checking Content-Type for JSON/XML to avoid SPA false positives. Identifies available API versions and the versioning strategy (URL path-based).

Why It's Useful

Understanding API versioning helps with integration planning, security assessment (older versions may have vulnerabilities), and competitive analysis of API maturity.

Use Cases

Developer

API Integration

Understand versioning strategy before integrating with an API.

Choose the right API version for integration.

Security Analyst

Security Assessment

Discover older API versions that may have known vulnerabilities.

Identify deprecated API versions for security testing.

API Architect

API Design Research

Study how other APIs implement versioning for best practices.

Learn from industry API versioning patterns.

Parameters

NameTypeRequiredDescription
domainstringRequiredThe domain to analyze API versioning forExample: api.example.com

Response Fields

FieldTypeDescription
domainstringThe queried domain
detectedbooleanWhether API versioning was detected
versioningMethodstringDetected strategy: url-path, header, or none
currentVersionstringDefault/current API version
supportedVersionsarrayAvailable API versions discovered
headersobjectVersion-related headers (apiVersion, acceptVersionSupported)
recommendationsarrayAPI versioning improvement suggestions

Code Examples

cURL
curl "https://api.edgedns.dev/v1/domain/api-version" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=api.example.com"
JavaScript
const response = await fetch(
  'https://api.edgedns.dev/v1/domain/api-version?domain=api.example.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);
Python
import requests

response = requests.get(
    'https://api.edgedns.dev/v1/domain/api-version',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'api.example.com'
    }
)

data = response.json()
print(data)

Read the full API Version Detection guide

Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.

Read the guide →

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.

Try This Endpoint

Test the API Version Detection endpoint live in the playground.