Tool API Platform

Use GET /api-tools/v1/plans to fetch request limits and optional billing metadata your app can read at runtime.

Configure Stripe to send events to POST /api-tools/v1/stripe/webhook. The endpoint verifies Stripe signatures and can auto-create/upgrade/revoke managed API keys from subscription events.

• Set TOOL_API_STRIPE_WEBHOOK_SECRET (required).
• Set TOOL_API_ADMIN_TOKEN to use admin retrieval/list APIs.
• Optional metadata: tool_api_plan, tool_api_price_id, tool_api_key_id.
• Handled events: subscription created/updated/deleted/paused/resumed, invoice paid/payment_failed, checkout completed/expired.

List tools

curl -sS https://internettoolset.com/api-tools/v1/tools | jq .

List plans (+ optional Stripe and checkout mappings)

curl -sS https://internettoolset.com/api-tools/v1/plans | jq .

Run one tool

curl -sS -X POST https://internettoolset.com/api-tools/v1/tools/mime-header-validator/run \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"input":{"extension":"pdf","declared_mime":"application/pdf","response_content_type":"application/pdf"}}' | jq .

Read current key usage

curl -sS https://internettoolset.com/api-tools/v1/account/usage \
  -H "X-API-Key: YOUR_API_KEY" | jq .

Admin: create managed key

curl -sS -X POST https://internettoolset.com/api-tools/v1/admin/keys \
  -H "Content-Type: application/json" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -d '{"plan":"builder","label":"Acme Production"}' | jq .

Admin: billing summary

curl -sS https://internettoolset.com/api-tools/v1/admin/billing/summary \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" | jq .

Stripe webhook endpoint

POST /api-tools/v1/stripe/webhook
Stripe-Signature: t=...,v1=...