# Status Codes¶

You can import the `status` module from `fastapi`:

```
from fastapi import status
```

`status` is provided directly by Starlette.

It contains a group of named constants (variables) with integer status codes.

For example:

- 200: `status.HTTP_200_OK`
- 403: `status.HTTP_403_FORBIDDEN`
- etc.

It can be convenient to quickly access HTTP (and WebSocket) status codes in your app, using autocompletion for the name without having to memorize the integer status codes.

Read more about it in the [FastAPI docs about Response Status Code](/guides/tutorial-user-guide-response-status-code).

## Example[¶](#example)

```
from fastapi import FastAPI, status

app = FastAPI()

@app.get("/items/", status_code=status.HTTP_418_IM_A_TEAPOT)
def read_items():
    return [{"name": "Plumbus"}, {"name": "Portal Gun"}]
```

## fastapi.status [¶](#fastapistatus-)

HTTP codes See HTTP Status Code Registry: https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml

And RFC 9110 - https://www.rfc-editor.org/rfc/rfc9110

### HTTP\_100\_CONTINUE `module-attribute` [¶](#http100continue-module-attribute-)

```
HTTP_100_CONTINUE = 100
```

### HTTP\_101\_SWITCHING\_PROTOCOLS `module-attribute` [¶](#http101switchingprotocols-module-attribute-)

```
HTTP_101_SWITCHING_PROTOCOLS = 101
```

### HTTP\_102\_PROCESSING `module-attribute` [¶](#http102processing-module-attribute-)

```
HTTP_102_PROCESSING = 102
```

### HTTP\_103\_EARLY\_HINTS `module-attribute` [¶](#http103earlyhints-module-attribute-)

```
HTTP_103_EARLY_HINTS = 103
```

### HTTP\_200\_OK `module-attribute` [¶](#http200ok-module-attribute-)

```
HTTP_200_OK = 200
```

### HTTP\_201\_CREATED `module-attribute` [¶](#http201created-module-attribute-)

```
HTTP_201_CREATED = 201
```

### HTTP\_202\_ACCEPTED `module-attribute` [¶](#http202accepted-module-attribute-)

```
HTTP_202_ACCEPTED = 202
```

### HTTP\_203\_NON\_AUTHORITATIVE\_INFORMATION `module-attribute` [¶](#http203nonauthoritativeinformation-module-attribute-)

```
HTTP_203_NON_AUTHORITATIVE_INFORMATION = 203
```

### HTTP\_204\_NO\_CONTENT `module-attribute` [¶](#http204nocontent-module-attribute-)

```
HTTP_204_NO_CONTENT = 204
```

### HTTP\_205\_RESET\_CONTENT `module-attribute` [¶](#http205resetcontent-module-attribute-)

```
HTTP_205_RESET_CONTENT = 205
```

### HTTP\_206\_PARTIAL\_CONTENT `module-attribute` [¶](#http206partialcontent-module-attribute-)

```
HTTP_206_PARTIAL_CONTENT = 206
```

### HTTP\_207\_MULTI\_STATUS `module-attribute` [¶](#http207multistatus-module-attribute-)

```
HTTP_207_MULTI_STATUS = 207
```

### HTTP\_208\_ALREADY\_REPORTED `module-attribute` [¶](#http208alreadyreported-module-attribute-)

```
HTTP_208_ALREADY_REPORTED = 208
```

### HTTP\_226\_IM\_USED `module-attribute` [¶](#http226imused-module-attribute-)

```
HTTP_226_IM_USED = 226
```

### HTTP\_300\_MULTIPLE\_CHOICES `module-attribute` [¶](#http300multiplechoices-module-attribute-)

```
HTTP_300_MULTIPLE_CHOICES = 300
```

### HTTP\_301\_MOVED\_PERMANENTLY `module-attribute` [¶](#http301movedpermanently-module-attribute-)

```
HTTP_301_MOVED_PERMANENTLY = 301
```

### HTTP\_302\_FOUND `module-attribute` [¶](#http302found-module-attribute-)

```
HTTP_302_FOUND = 302
```

### HTTP\_303\_SEE\_OTHER `module-attribute` [¶](#http303seeother-module-attribute-)

```
HTTP_303_SEE_OTHER = 303
```

### HTTP\_304\_NOT\_MODIFIED `module-attribute` [¶](#http304notmodified-module-attribute-)

```
HTTP_304_NOT_MODIFIED = 304
```

### HTTP\_305\_USE\_PROXY `module-attribute` [¶](#http305useproxy-module-attribute-)

```
HTTP_305_USE_PROXY = 305
```

### HTTP\_306\_RESERVED `module-attribute` [¶](#http306reserved-module-attribute-)

```
HTTP_306_RESERVED = 306
```

### HTTP\_307\_TEMPORARY\_REDIRECT `module-attribute` [¶](#http307temporaryredirect-module-attribute-)

```
HTTP_307_TEMPORARY_REDIRECT = 307
```

### HTTP\_308\_PERMANENT\_REDIRECT `module-attribute` [¶](#http308permanentredirect-module-attribute-)

```
HTTP_308_PERMANENT_REDIRECT = 308
```

### HTTP\_400\_BAD\_REQUEST `module-attribute` [¶](#http400badrequest-module-attribute-)

```
HTTP_400_BAD_REQUEST = 400
```

### HTTP\_401\_UNAUTHORIZED `module-attribute` [¶](#http401unauthorized-module-attribute-)

```
HTTP_401_UNAUTHORIZED = 401
```

### HTTP\_402\_PAYMENT\_REQUIRED `module-attribute` [¶](#http402paymentrequired-module-attribute-)

```
HTTP_402_PAYMENT_REQUIRED = 402
```

### HTTP\_403\_FORBIDDEN `module-attribute` [¶](#http403forbidden-module-attribute-)

```
HTTP_403_FORBIDDEN = 403
```

### HTTP\_404\_NOT\_FOUND `module-attribute` [¶](#http404notfound-module-attribute-)

```
HTTP_404_NOT_FOUND = 404
```

### HTTP\_405\_METHOD\_NOT\_ALLOWED `module-attribute` [¶](#http405methodnotallowed-module-attribute-)

```
HTTP_405_METHOD_NOT_ALLOWED = 405
```

### HTTP\_406\_NOT\_ACCEPTABLE `module-attribute` [¶](#http406notacceptable-module-attribute-)

```
HTTP_406_NOT_ACCEPTABLE = 406
```

### HTTP\_407\_PROXY\_AUTHENTICATION\_REQUIRED `module-attribute` [¶](#http407proxyauthenticationrequired-module-attribute-)

```
HTTP_407_PROXY_AUTHENTICATION_REQUIRED = 407
```

### HTTP\_408\_REQUEST\_TIMEOUT `module-attribute` [¶](#http408requesttimeout-module-attribute-)

```
HTTP_408_REQUEST_TIMEOUT = 408
```

### HTTP\_409\_CONFLICT `module-attribute` [¶](#http409conflict-module-attribute-)

```
HTTP_409_CONFLICT = 409
```

### HTTP\_410\_GONE `module-attribute` [¶](#http410gone-module-attribute-)

```
HTTP_410_GONE = 410
```

### HTTP\_411\_LENGTH\_REQUIRED `module-attribute` [¶](#http411lengthrequired-module-attribute-)

```
HTTP_411_LENGTH_REQUIRED = 411
```

### HTTP\_412\_PRECONDITION\_FAILED `module-attribute` [¶](#http412preconditionfailed-module-attribute-)

```
HTTP_412_PRECONDITION_FAILED = 412
```

### HTTP\_413\_CONTENT\_TOO\_LARGE `module-attribute` [¶](#http413contenttoolarge-module-attribute-)

```
HTTP_413_CONTENT_TOO_LARGE = 413
```

### HTTP\_414\_URI\_TOO\_LONG `module-attribute` [¶](#http414uritoolong-module-attribute-)

```
HTTP_414_URI_TOO_LONG = 414
```

### HTTP\_415\_UNSUPPORTED\_MEDIA\_TYPE `module-attribute` [¶](#http415unsupportedmediatype-module-attribute-)

```
HTTP_415_UNSUPPORTED_MEDIA_TYPE = 415
```

### HTTP\_416\_RANGE\_NOT\_SATISFIABLE `module-attribute` [¶](#http416rangenotsatisfiable-module-attribute-)

```
HTTP_416_RANGE_NOT_SATISFIABLE = 416
```

### HTTP\_417\_EXPECTATION\_FAILED `module-attribute` [¶](#http417expectationfailed-module-attribute-)

```
HTTP_417_EXPECTATION_FAILED = 417
```

### HTTP\_418\_IM\_A\_TEAPOT `module-attribute` [¶](#http418imateapot-module-attribute-)

```
HTTP_418_IM_A_TEAPOT = 418
```

### HTTP\_421\_MISDIRECTED\_REQUEST `module-attribute` [¶](#http421misdirectedrequest-module-attribute-)

```
HTTP_421_MISDIRECTED_REQUEST = 421
```

### HTTP\_422\_UNPROCESSABLE\_CONTENT `module-attribute` [¶](#http422unprocessablecontent-module-attribute-)

```
HTTP_422_UNPROCESSABLE_CONTENT = 422
```

### HTTP\_423\_LOCKED `module-attribute` [¶](#http423locked-module-attribute-)

```
HTTP_423_LOCKED = 423
```

### HTTP\_424\_FAILED\_DEPENDENCY `module-attribute` [¶](#http424faileddependency-module-attribute-)

```
HTTP_424_FAILED_DEPENDENCY = 424
```

### HTTP\_425\_TOO\_EARLY `module-attribute` [¶](#http425tooearly-module-attribute-)

```
HTTP_425_TOO_EARLY = 425
```

### HTTP\_426\_UPGRADE\_REQUIRED `module-attribute` [¶](#http426upgraderequired-module-attribute-)

```
HTTP_426_UPGRADE_REQUIRED = 426
```

### HTTP\_428\_PRECONDITION\_REQUIRED `module-attribute` [¶](#http428preconditionrequired-module-attribute-)

```
HTTP_428_PRECONDITION_REQUIRED = 428
```

### HTTP\_429\_TOO\_MANY\_REQUESTS `module-attribute` [¶](#http429toomanyrequests-module-attribute-)

```
HTTP_429_TOO_MANY_REQUESTS = 429
```

### HTTP\_431\_REQUEST\_HEADER\_FIELDS\_TOO\_LARGE `module-attribute` [¶](#http431requestheaderfieldstoolarge-module-attribute-)

```
HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE = 431
```

### HTTP\_451\_UNAVAILABLE\_FOR\_LEGAL\_REASONS `module-attribute` [¶](#http451unavailableforlegalreasons-module-attribute-)

```
HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS = 451
```

### HTTP\_500\_INTERNAL\_SERVER\_ERROR `module-attribute` [¶](#http500internalservererror-module-attribute-)

```
HTTP_500_INTERNAL_SERVER_ERROR = 500
```

### HTTP\_501\_NOT\_IMPLEMENTED `module-attribute` [¶](#http501notimplemented-module-attribute-)

```
HTTP_501_NOT_IMPLEMENTED = 501
```

### HTTP\_502\_BAD\_GATEWAY `module-attribute` [¶](#http502badgateway-module-attribute-)

```
HTTP_502_BAD_GATEWAY = 502
```

### HTTP\_503\_SERVICE\_UNAVAILABLE `module-attribute` [¶](#http503serviceunavailable-module-attribute-)

```
HTTP_503_SERVICE_UNAVAILABLE = 503
```

### HTTP\_504\_GATEWAY\_TIMEOUT `module-attribute` [¶](#http504gatewaytimeout-module-attribute-)

```
HTTP_504_GATEWAY_TIMEOUT = 504
```

### HTTP\_505\_HTTP\_VERSION\_NOT\_SUPPORTED `module-attribute` [¶](#http505httpversionnotsupported-module-attribute-)

```
HTTP_505_HTTP_VERSION_NOT_SUPPORTED = 505
```

### HTTP\_506\_VARIANT\_ALSO\_NEGOTIATES `module-attribute` [¶](#http506variantalsonegotiates-module-attribute-)

```
HTTP_506_VARIANT_ALSO_NEGOTIATES = 506
```

### HTTP\_507\_INSUFFICIENT\_STORAGE `module-attribute` [¶](#http507insufficientstorage-module-attribute-)

```
HTTP_507_INSUFFICIENT_STORAGE = 507
```

### HTTP\_508\_LOOP\_DETECTED `module-attribute` [¶](#http508loopdetected-module-attribute-)

```
HTTP_508_LOOP_DETECTED = 508
```

### HTTP\_510\_NOT\_EXTENDED `module-attribute` [¶](#http510notextended-module-attribute-)

```
HTTP_510_NOT_EXTENDED = 510
```

### HTTP\_511\_NETWORK\_AUTHENTICATION\_REQUIRED `module-attribute` [¶](#http511networkauthenticationrequired-module-attribute-)

```
HTTP_511_NETWORK_AUTHENTICATION_REQUIRED = 511
```

WebSocket codes https://www.iana.org/assignments/websocket/websocket.xml#close-code-number https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent

### WS\_1000\_NORMAL\_CLOSURE `module-attribute` [¶](#ws1000normalclosure-module-attribute-)

```
WS_1000_NORMAL_CLOSURE = 1000
```

### WS\_1001\_GOING\_AWAY `module-attribute` [¶](#ws1001goingaway-module-attribute-)

```
WS_1001_GOING_AWAY = 1001
```

### WS\_1002\_PROTOCOL\_ERROR `module-attribute` [¶](#ws1002protocolerror-module-attribute-)

```
WS_1002_PROTOCOL_ERROR = 1002
```

### WS\_1003\_UNSUPPORTED\_DATA `module-attribute` [¶](#ws1003unsupporteddata-module-attribute-)

```
WS_1003_UNSUPPORTED_DATA = 1003
```

### WS\_1005\_NO\_STATUS\_RCVD `module-attribute` [¶](#ws1005nostatusrcvd-module-attribute-)

```
WS_1005_NO_STATUS_RCVD = 1005
```

### WS\_1006\_ABNORMAL\_CLOSURE `module-attribute` [¶](#ws1006abnormalclosure-module-attribute-)

```
WS_1006_ABNORMAL_CLOSURE = 1006
```

### WS\_1007\_INVALID\_FRAME\_PAYLOAD\_DATA `module-attribute` [¶](#ws1007invalidframepayloaddata-module-attribute-)

```
WS_1007_INVALID_FRAME_PAYLOAD_DATA = 1007
```

### WS\_1008\_POLICY\_VIOLATION `module-attribute` [¶](#ws1008policyviolation-module-attribute-)

```
WS_1008_POLICY_VIOLATION = 1008
```

### WS\_1009\_MESSAGE\_TOO\_BIG `module-attribute` [¶](#ws1009messagetoobig-module-attribute-)

```
WS_1009_MESSAGE_TOO_BIG = 1009
```

### WS\_1010\_MANDATORY\_EXT `module-attribute` [¶](#ws1010mandatoryext-module-attribute-)

```
WS_1010_MANDATORY_EXT = 1010
```

### WS\_1011\_INTERNAL\_ERROR `module-attribute` [¶](#ws1011internalerror-module-attribute-)

```
WS_1011_INTERNAL_ERROR = 1011
```

### WS\_1012\_SERVICE\_RESTART `module-attribute` [¶](#ws1012servicerestart-module-attribute-)

```
WS_1012_SERVICE_RESTART = 1012
```

### WS\_1013\_TRY\_AGAIN\_LATER `module-attribute` [¶](#ws1013tryagainlater-module-attribute-)

```
WS_1013_TRY_AGAIN_LATER = 1013
```

### WS\_1014\_BAD\_GATEWAY `module-attribute` [¶](#ws1014badgateway-module-attribute-)

```
WS_1014_BAD_GATEWAY = 1014
```

### WS\_1015\_TLS\_HANDSHAKE `module-attribute` [¶](#ws1015tlshandshake-module-attribute-)

```
WS_1015_TLS_HANDSHAKE = 1015
```

## Related pages

- [About](./about-index.md)
- [Advanced User Guide](./advanced-user-guide-index.md)
- [Deployment](./deployment-index.md)
- [FastAPI](./fastapi-index.md)
- [FastAPI Docs](../index.md)
- [Features](./features-index.md)
- [How To - Recipes](./how-to-recipes-index.md)
- [Learn](./learn-index.md)
- [More](./more-index.md)
- [OpenAPI](./openapi-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.