HTTP

HTTP 202 Accepted vs 503 Service Unavailable

HTTP 202 (Accepted) is a 2xx Success response, while 503 (Service Unavailable) is a 5xx Server Error response. 202 indicates that the request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon. In contrast, 503 means that the server is temporarily unable to handle the request due to maintenance or overload. Should include a Retry-After header.

Description

The request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon.

When You See It

For async operations like batch jobs, email sending, or background tasks that take time to complete.

How to Fix

Poll the provided status URL or wait for a callback/webhook.

Description

The server is temporarily unable to handle the request due to maintenance or overload. Should include a Retry-After header.

When You See It

During maintenance windows, server overload, or when the application pool is exhausted.

How to Fix

Wait and retry. Check the Retry-After header. Scale up servers if it's a capacity issue.

Key Differences

1.

202 is a 2xx Success response, while 503 is a 5xx Server Error response.

2.

HTTP 202: The request has been accepted for processing, but the processing has not been completed. The request might or might not eventually be acted upon.

3.

HTTP 503: The server is temporarily unable to handle the request due to maintenance or overload. Should include a Retry-After header.

4.

You encounter 202 when for async operations like batch jobs, email sending, or background tasks that take time to complete.

5.

You encounter 503 when during maintenance windows, server overload, or when the application pool is exhausted.

When to Use Which

For 202 (Accepted): Poll the provided status URL or wait for a callback/webhook. For 503 (Service Unavailable): Wait and retry. Check the Retry-After header. Scale up servers if it's a capacity issue.

Learn More