Amazon API Gateway's two API types — the cheaper default, and what still needs the original.
HTTP API is the right default for new APIs — roughly a third of the price per million requests, and it covers the common cases: Lambda and HTTP proxy integrations, JWT / Lambda / IAM authorization, CORS, custom domains. Choose REST API when you specifically need API keys with usage plans, AWS WAF, a private (VPC-only) endpoint, request validation, response caching, an edge-optimized endpoint, or body transformation. The deciding factor: if you need API keys plus usage plans, WAF, or a private endpoint, you must use REST API — HTTP API does not offer them.
| Criterion | REST API | HTTP API |
|---|---|---|
| Price per million requests | $3.50 (first tier) | $1.00 (first tier) |
| API keys & usage plans | Yes — per-client throttling and quotas | No |
| AWS WAF integration | Yes | No |
| Private (VPC-only) endpoint | Yes | No |
| JWT authorizer | No — use a Lambda authorizer for JWTs | Yes — native |
| Request validation | Yes | No |
| Body transformation | Yes — VTL mapping templates | No — parameter mapping only |
| Response caching | Yes — per-stage | No |
| Edge-optimized endpoint | Yes | No |