• Pricing
© 2026 Serverless, Inc. All rights reserved.

Framework

  • Overview
  • Documentation
  • Plugins360
  • Pricing

Learn

  • Blog
  • GuidesUpdated
  • Examples240
  • Courses

Resources

  • Support
  • Security
  • Trust Center
  • Status

Community

  • Slack
  • GitHub47k
  • Forum
  • Meetups

Company

  • About
  • Careers
  • Contact
  • Partners

Legal

  • Terms of Service
  • Privacy Policy
  • Trademark
  • DMCA
Updated March 2026

The Ultimate Guide to
AWS HTTP APIs

AWS HTTP APIs are the newer, faster, and cheaper way to build RESTful APIs on Amazon API Gateway. They offer up to 71% cost savings and 60% lower latency compared to REST APIs, with native JWT auth and simplified configuration.

Build an HTTP APIRead the Docs

AWS HTTP API Key Features

HTTP APIs strip away complexity and cost while keeping the features most serverless applications actually need.

Pricing

71% Lower Cost

HTTP APIs cost $1.00 per million requests compared to $3.50 for REST APIs. At scale, this translates to hundreds or thousands of dollars in monthly savings.

Performance

60% Lower Latency

HTTP APIs add roughly 10ms of overhead at p99, compared to tens of milliseconds for REST APIs. This makes serverless viable for latency-sensitive workloads.

Security

Native JWT Authorization

Built-in JWT validation with any OpenID Connect provider. No custom Lambda authorizers needed for Cognito, Auth0, or Okta token verification.

Networking

Automatic CORS

Configure CORS headers at the API level instead of in every Lambda handler. Set allowed origins, methods, and headers once and they apply to all routes.

Architecture

Simplified Routing

Define routes with HTTP method and path. No separate deployment resources or complex stage configurations. Catch-all routes supported for single-function APIs.

Developer Experience

Payload v2.0 Format

A cleaner, leaner event payload with optional simplified responses. Lambda functions can return a plain body string instead of the full status code wrapper.

How HTTP APIs Work

HTTP APIs sit between clients and your backend services. They handle routing, authorization, and CORS so your Lambda functions focus purely on business logic.

1

Authorize

A client sends an HTTP request. HTTP API validates any JWT token against your configured issuer and audience, rejecting unauthorized requests before they reach your backend.

2

Route

The request is matched to a route by HTTP method and path. HTTP API forwards it to the integration target: a Lambda function, another HTTP endpoint, or a private VPC resource.

3

Respond

Your backend returns a response. HTTP API applies CORS headers automatically and sends the result to the client. The entire round-trip adds roughly 10ms of overhead.

Integration Targets

HTTP APIs connect to several backend types, each suited to different use cases:

AWS Lambda

The most common integration. Run functions to generate API responses with automatic scaling and pay-per-invocation pricing.

HTTP Endpoints

Proxy requests to any public URL or internal service. Useful for migrating existing APIs behind a managed gateway.

Private VPC Resources

Connect to ECS, EKS, EC2, or NLB targets inside your VPC via VPC Link for internal microservices.

AWS Service Integrations

Route directly to services like SQS, Step Functions, or EventBridge without a Lambda function in between.

REST API vs. HTTP API

AWS offers two API Gateway types. HTTP APIs are the newer, leaner option. REST APIs have more features but cost more and add more latency.

FeatureREST APIHTTP API
Cost (per 1M requests)$3.50$1.00
Latency overheadHigher (tens of ms)~10ms at p99
JWT authorizationVia Lambda authorizerNative support
CORS configurationManual per-method setupAPI-level config
Request validationYes (JSON Schema)No
WAF integrationYesNo
Usage plans / API keysYesNo
Response cachingYesNo
Private APIs (VPC endpoint)YesNo
Edge-optimized deploymentYesNo
Catch-all routesNoYes
Payload v2.0 formatNoYes (optional)

For a deeper look at API Gateway as a whole, see our Ultimate Guide to Amazon API Gateway.

Using HTTP APIs with the Serverless Framework

The Serverless Framework makes HTTP APIs the default for new projects. Define your routes in serverless.yml and the framework handles all the CloudFormation resources, permissions, and deployment stages:

serverless.yml
service: my-http-api

provider:
  name: aws
  runtime: nodejs22.x
  httpApi:
    cors: true
    authorizers:
      myJwtAuth:
        type: jwt
        identitySource: $request.header.Authorization
        issuerUrl: https://cognito-idp.us-east-1.amazonaws.com/us-east-1_abc123
        audience:
          - my-app-client-id

functions:
  listUsers:
    handler: handler.listUsers
    events:
      - httpApi:
          path: /users
          method: get

  getUser:
    handler: handler.getUser
    events:
      - httpApi:
          path: /users/{id}
          method: get
          authorizer:
            name: myJwtAuth

  createUser:
    handler: handler.createUser
    events:
      - httpApi:
          path: /users
          method: post
          authorizer:
            name: myJwtAuth

The httpApi event type creates HTTP API routes automatically. CORS is configured once at the provider level. JWT authorizers are defined once and referenced by name on any route that needs protection.

Benefits of HTTP APIs

Dramatic Cost Savings

At $1.00 per million requests (vs. $3.50 for REST APIs), HTTP APIs deliver a 71% cost reduction. For a service handling 100 million requests per month, that is $250 saved every month. At higher volumes the savings compound further, with tiered pricing dropping to $0.90 per million above 300 million requests.

Lower Latency for Real Workloads

HTTP APIs add roughly 10ms of overhead at p99, a 60% improvement over REST APIs. This makes API Gateway viable for latency-sensitive applications in ad-tech, financial services, and gaming that previously avoided serverless because of gateway overhead.

Simpler Developer Experience

HTTP APIs require fewer CloudFormation resources per route, reducing stack complexity and deployment times. Auto-deploy stages, API-level CORS, and catch-all routing mean less boilerplate configuration. The Serverless Framework makes the experience even simpler by abstracting the remaining setup.

Managed JWT Authentication

Native JWT authorization replaces the need for custom Lambda authorizers that extract tokens, verify signatures, and generate IAM policies. HTTP APIs handle all of that automatically, reducing auth code, latency, and Lambda invocation costs.

Trade-offs & Limitations

HTTP APIs trade advanced features for simplicity and cost savings. These gaps matter for specific use cases.

No usage plans or API keys

If you need to meter, throttle, or monetize API access per consumer, you must use REST APIs. HTTP APIs have no built-in mechanism for issuing or validating API keys.

No request/response validation

REST APIs can validate incoming JSON payloads against a schema before invoking your Lambda function. With HTTP APIs, all validation must happen inside your function code.

No response caching

REST APIs offer built-in response caching at the gateway layer. HTTP APIs have no caching. Use CloudFront, DynamoDB DAX, or application-level caching as alternatives.

No WAF integration

AWS WAF (Web Application Firewall) can be attached to REST APIs but not HTTP APIs. For WAF protection, place CloudFront in front of your HTTP API and attach WAF to the distribution.

No edge-optimized or private APIs

HTTP APIs are regional only. They do not support edge-optimized deployments or VPC endpoint policies for private API access. REST APIs are required for those patterns.

30-second integration timeout

Backend integrations must respond within 30 seconds. For long-running operations, accept the request immediately, return a job ID, and process asynchronously.

No wildcard custom subdomains

HTTP APIs do not support wildcard custom domain names. Each subdomain must be configured individually, which limits multi-tenant architectures that rely on tenant-specific subdomains.

No request/response transformation templates

REST APIs offer Velocity Template Language (VTL) mappings to transform requests and responses at the gateway layer. HTTP APIs pass payloads through as-is, so all transformation logic must live in your function code.

No X-Ray tracing support

HTTP APIs do not integrate with AWS X-Ray for distributed tracing. Observability is limited to CloudWatch access logs and metrics. For end-to-end tracing, instrument your Lambda functions directly.

HTTP API Pricing

HTTP APIs use simple, tiered request pricing with no minimum fees. They are significantly cheaper than REST APIs at every volume level.

Free Tier (First 12 Months)

1M

HTTP API calls / month

750K

connection minutes / month

VolumePrice per Million
First 300M requests / month$1.00
Above 300M requests / month$0.90

Cost Comparison: 100M Requests / Month

100M requests x $1.00/1M (HTTP API) = $100/month

100M requests x $3.50/1M (REST API) = $350/month

Savings: $250/month (71%). At 600M requests, HTTP API costs $570 vs. $2,100 for REST API.

See the official API Gateway pricing page for current regional rates.

When to Use HTTP APIs

Use HTTP APIs when you are building new serverless REST APIs, want the lowest possible cost and latency, need JWT-based authentication, or are migrating from REST APIs and do not rely on usage plans, caching, or WAF. HTTP APIs are the right default for most new projects.

Consider REST APIs instead when you need request validation, API key management, usage plans, response caching, WAF integration, edge-optimized endpoints, or private APIs. These features are only available on REST APIs.

Consider alternatives when you are building a GraphQL API (use AWS AppSync), need a simple single-function endpoint without a full gateway (use Lambda Function URLs), or need sub-millisecond routing (run your own reverse proxy).

Learn More

Documentation

  • HTTP API Event Docs
  • Amazon API Gateway Guide
  • AWS Lambda Guide
  • AWS HTTP API Docs

Related Guides

  • Amazon CloudFront (CDN)
  • AWS AppSync (GraphQL)
  • Amazon DynamoDB
  • Browse all guides

HTTP API Limits

Key quotas to plan around. Most soft limits can be raised through AWS Support.

LimitValue
Integration timeout30 seconds
Payload size10 MB
Routes per API300
Stages per API10
Authorizers per API10
Auth endpoint JWKS timeout1,500 ms
Custom domains per account120
Throttle rate10,000 requests/second (adjustable)
Burst limit5,000 requests

HTTP API FAQ

Common questions about AWS HTTP APIs.

What are AWS HTTP APIs?
AWS HTTP APIs are the newer, lighter version of Amazon API Gateway. They provide a simpler way to create RESTful APIs with lower latency and lower cost than the original REST API type, while supporting Lambda integrations, JWT authorization, and CORS out of the box.
What is the difference between REST API and HTTP API?
HTTP APIs cost up to 71% less and have up to 60% lower latency than REST APIs. REST APIs offer more features like request validation, WAF integration, usage plans, API keys, and caching. For most new serverless projects, HTTP APIs are the better default choice.
How much do AWS HTTP APIs cost?
The first 300 million requests per month cost $1.00 per million. Requests above 300 million cost $0.90 per million. The free tier includes 1 million HTTP API calls per month for the first 12 months after account creation.
Do HTTP APIs support authentication?
Yes. HTTP APIs have native JWT authorizer support, which works with any OpenID Connect provider including Amazon Cognito, Auth0, and Okta. This eliminates the need for custom Lambda authorizers to validate tokens.
What is the maximum timeout for HTTP APIs?
HTTP APIs have a 30-second integration timeout. If your backend does not respond within 30 seconds, the request will fail. For longer operations, use an asynchronous pattern: accept the request immediately and process in the background.
Can I migrate from REST API to HTTP API?
Yes. REST and HTTP APIs can share custom domains, so you can migrate endpoints incrementally. Map new or updated routes to HTTP API while keeping existing routes on REST API, then migrate the rest over time.
Do HTTP APIs support WebSocket?
No. WebSocket APIs are a separate API Gateway type. If you need real-time WebSocket connections, use API Gateway WebSocket APIs. HTTP APIs are designed specifically for RESTful HTTP request/response patterns.

Build Your First HTTP API

Deploy a fast, cheap HTTP API with Lambda in minutes
using the Serverless Framework.

Get Started FreeView Documentation