Skip to main content

Technical documentation

Version 3

Release date

axesPAC V3 will be released on 10 August 2026, 4 p.m. CEST.

OpenAPI documentation

The OpenAPI documentation for axesPAC v3 is available here. Please use an online Swagger editor to display it in a human-friendly format if needed.

(As axesPAC V3 is not officially published yet, we currently provide the documentation as a download file.)

Release Notes

Changed Endpoints

All endpoints now contain the subscription ID as part of the URL. Some endpoints were removed; they are available under a new base URL.

v2 v3
/v2/jobs /v3/subscription/{subscriptionId}/jobs
/v2/jobs/{jobId}/report/summary /v3/subscription/{subscriptionId}/jobs/{jobId}/report/summary
/v2/jobs/{jobId}/report/details /v3/subscription/{subscriptionId}/jobs/{jobId}/report/details
/v2/apiKey/valid [removed] Replacement available, see https://api.axes4.com/usage/pages/public/openapi/v3
/v2/apiKey/usage [removed] Replacement available, see https://api.axes4.com/usage/pages/public/openapi/v3

Changes

  • Removed author from the summary report

Version 2

Breaking change

The header name api-key will be changed to x-api-key on 10 August 2026 between 3 p.m. and 4 p.m. CEST.

New Endpoints

  • /v2/apiKey/usage can be used to determine the usage of your API key (number of pages).

OpenAPI documentation

The OpenAPI documentation for axesPAC v2 is available here. Please use an online Swagger editor to display it in a human-friendly format if needed.

Changes

Jobs POST /v2/jobs

  v1 v2
Defective PDF documents Returns a 422 Unprocessable Entity status code Only the respective check and its subordinate checks are terminated, resulting in Severity = terminated
Transmission base64 JSON application/pdf or application/octet-stream
File size limit 20 MB (since September 9, 2025) 80 MB

Summary report GET /v2/jobs/{jobId}/report/summary

  v1 v2
Check node ID name "id" "checkId"
Issues Added "issueId"

Detailed report GET /v2/jobs/{jobId}/report/details

  v1 v2
Check node ID name "id" "checkId"
Issues Added "issueId"

Report Retention

All reports are stored for 60 days and can be accessed during this period. After that, they are permanently deleted.