# 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 ``` 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 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` ``` HTTP_100_CONTINUE = 100 ``` ### HTTP\_101\_SWITCHING\_PROTOCOLS `module-attribute` ``` HTTP_101_SWITCHING_PROTOCOLS = 101 ``` ### HTTP\_102\_PROCESSING `module-attribute` ``` HTTP_102_PROCESSING = 102 ``` ### HTTP\_103\_EARLY\_HINTS `module-attribute` ``` HTTP_103_EARLY_HINTS = 103 ``` ### HTTP\_200\_OK `module-attribute` ``` HTTP_200_OK = 200 ``` ### HTTP\_201\_CREATED `module-attribute` ``` HTTP_201_CREATED = 201 ``` ### HTTP\_202\_ACCEPTED `module-attribute` ``` HTTP_202_ACCEPTED = 202 ``` ### HTTP\_203\_NON\_AUTHORITATIVE\_INFORMATION `module-attribute` ``` HTTP_203_NON_AUTHORITATIVE_INFORMATION = 203 ``` ### HTTP\_204\_NO\_CONTENT `module-attribute` ``` HTTP_204_NO_CONTENT = 204 ``` ### HTTP\_205\_RESET\_CONTENT `module-attribute` ``` HTTP_205_RESET_CONTENT = 205 ``` ### HTTP\_206\_PARTIAL\_CONTENT `module-attribute` ``` HTTP_206_PARTIAL_CONTENT = 206 ``` ### HTTP\_207\_MULTI\_STATUS `module-attribute` ``` HTTP_207_MULTI_STATUS = 207 ``` ### HTTP\_208\_ALREADY\_REPORTED `module-attribute` ``` HTTP_208_ALREADY_REPORTED = 208 ``` ### HTTP\_226\_IM\_USED `module-attribute` ``` HTTP_226_IM_USED = 226 ``` ### HTTP\_300\_MULTIPLE\_CHOICES `module-attribute` ``` HTTP_300_MULTIPLE_CHOICES = 300 ``` ### HTTP\_301\_MOVED\_PERMANENTLY `module-attribute` ``` HTTP_301_MOVED_PERMANENTLY = 301 ``` ### HTTP\_302\_FOUND `module-attribute` ``` HTTP_302_FOUND = 302 ``` ### HTTP\_303\_SEE\_OTHER `module-attribute` ``` HTTP_303_SEE_OTHER = 303 ``` ### HTTP\_304\_NOT\_MODIFIED `module-attribute` ``` HTTP_304_NOT_MODIFIED = 304 ``` ### HTTP\_305\_USE\_PROXY `module-attribute` ``` HTTP_305_USE_PROXY = 305 ``` ### HTTP\_306\_RESERVED `module-attribute` ``` HTTP_306_RESERVED = 306 ``` ### HTTP\_307\_TEMPORARY\_REDIRECT `module-attribute` ``` HTTP_307_TEMPORARY_REDIRECT = 307 ``` ### HTTP\_308\_PERMANENT\_REDIRECT `module-attribute` ``` HTTP_308_PERMANENT_REDIRECT = 308 ``` ### HTTP\_400\_BAD\_REQUEST `module-attribute` ``` HTTP_400_BAD_REQUEST = 400 ``` ### HTTP\_401\_UNAUTHORIZED `module-attribute` ``` HTTP_401_UNAUTHORIZED = 401 ``` ### HTTP\_402\_PAYMENT\_REQUIRED `module-attribute` ``` HTTP_402_PAYMENT_REQUIRED = 402 ``` ### HTTP\_403\_FORBIDDEN `module-attribute` ``` HTTP_403_FORBIDDEN = 403 ``` ### HTTP\_404\_NOT\_FOUND `module-attribute` ``` HTTP_404_NOT_FOUND = 404 ``` ### HTTP\_405\_METHOD\_NOT\_ALLOWED `module-attribute` ``` HTTP_405_METHOD_NOT_ALLOWED = 405 ``` ### HTTP\_406\_NOT\_ACCEPTABLE `module-attribute` ``` HTTP_406_NOT_ACCEPTABLE = 406 ``` ### HTTP\_407\_PROXY\_AUTHENTICATION\_REQUIRED `module-attribute` ``` HTTP_407_PROXY_AUTHENTICATION_REQUIRED = 407 ``` ### HTTP\_408\_REQUEST\_TIMEOUT `module-attribute` ``` HTTP_408_REQUEST_TIMEOUT = 408 ``` ### HTTP\_409\_CONFLICT `module-attribute` ``` HTTP_409_CONFLICT = 409 ``` ### HTTP\_410\_GONE `module-attribute` ``` HTTP_410_GONE = 410 ``` ### HTTP\_411\_LENGTH\_REQUIRED `module-attribute` ``` HTTP_411_LENGTH_REQUIRED = 411 ``` ### HTTP\_412\_PRECONDITION\_FAILED `module-attribute` ``` HTTP_412_PRECONDITION_FAILED = 412 ``` ### HTTP\_413\_CONTENT\_TOO\_LARGE `module-attribute` ``` HTTP_413_CONTENT_TOO_LARGE = 413 ``` ### HTTP\_414\_URI\_TOO\_LONG `module-attribute` ``` HTTP_414_URI_TOO_LONG = 414 ``` ### HTTP\_415\_UNSUPPORTED\_MEDIA\_TYPE `module-attribute` ``` HTTP_415_UNSUPPORTED_MEDIA_TYPE = 415 ``` ### HTTP\_416\_RANGE\_NOT\_SATISFIABLE `module-attribute` ``` HTTP_416_RANGE_NOT_SATISFIABLE = 416 ``` ### HTTP\_417\_EXPECTATION\_FAILED `module-attribute` ``` HTTP_417_EXPECTATION_FAILED = 417 ``` ### HTTP\_418\_IM\_A\_TEAPOT `module-attribute` ``` HTTP_418_IM_A_TEAPOT = 418 ``` ### HTTP\_421\_MISDIRECTED\_REQUEST `module-attribute` ``` HTTP_421_MISDIRECTED_REQUEST = 421 ``` ### HTTP\_422\_UNPROCESSABLE\_CONTENT `module-attribute` ``` HTTP_422_UNPROCESSABLE_CONTENT = 422 ``` ### HTTP\_423\_LOCKED `module-attribute` ``` HTTP_423_LOCKED = 423 ``` ### HTTP\_424\_FAILED\_DEPENDENCY `module-attribute` ``` HTTP_424_FAILED_DEPENDENCY = 424 ``` ### HTTP\_425\_TOO\_EARLY `module-attribute` ``` HTTP_425_TOO_EARLY = 425 ``` ### HTTP\_426\_UPGRADE\_REQUIRED `module-attribute` ``` HTTP_426_UPGRADE_REQUIRED = 426 ``` ### HTTP\_428\_PRECONDITION\_REQUIRED `module-attribute` ``` HTTP_428_PRECONDITION_REQUIRED = 428 ``` ### HTTP\_429\_TOO\_MANY\_REQUESTS `module-attribute` ``` HTTP_429_TOO_MANY_REQUESTS = 429 ``` ### HTTP\_431\_REQUEST\_HEADER\_FIELDS\_TOO\_LARGE `module-attribute` ``` HTTP_431_REQUEST_HEADER_FIELDS_TOO_LARGE = 431 ``` ### HTTP\_451\_UNAVAILABLE\_FOR\_LEGAL\_REASONS `module-attribute` ``` HTTP_451_UNAVAILABLE_FOR_LEGAL_REASONS = 451 ``` ### HTTP\_500\_INTERNAL\_SERVER\_ERROR `module-attribute` ``` HTTP_500_INTERNAL_SERVER_ERROR = 500 ``` ### HTTP\_501\_NOT\_IMPLEMENTED `module-attribute` ``` HTTP_501_NOT_IMPLEMENTED = 501 ``` ### HTTP\_502\_BAD\_GATEWAY `module-attribute` ``` HTTP_502_BAD_GATEWAY = 502 ``` ### HTTP\_503\_SERVICE\_UNAVAILABLE `module-attribute` ``` HTTP_503_SERVICE_UNAVAILABLE = 503 ``` ### HTTP\_504\_GATEWAY\_TIMEOUT `module-attribute` ``` HTTP_504_GATEWAY_TIMEOUT = 504 ``` ### HTTP\_505\_HTTP\_VERSION\_NOT\_SUPPORTED `module-attribute` ``` HTTP_505_HTTP_VERSION_NOT_SUPPORTED = 505 ``` ### HTTP\_506\_VARIANT\_ALSO\_NEGOTIATES `module-attribute` ``` HTTP_506_VARIANT_ALSO_NEGOTIATES = 506 ``` ### HTTP\_507\_INSUFFICIENT\_STORAGE `module-attribute` ``` HTTP_507_INSUFFICIENT_STORAGE = 507 ``` ### HTTP\_508\_LOOP\_DETECTED `module-attribute` ``` HTTP_508_LOOP_DETECTED = 508 ``` ### HTTP\_510\_NOT\_EXTENDED `module-attribute` ``` HTTP_510_NOT_EXTENDED = 510 ``` ### HTTP\_511\_NETWORK\_AUTHENTICATION\_REQUIRED `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` ``` WS_1000_NORMAL_CLOSURE = 1000 ``` ### WS\_1001\_GOING\_AWAY `module-attribute` ``` WS_1001_GOING_AWAY = 1001 ``` ### WS\_1002\_PROTOCOL\_ERROR `module-attribute` ``` WS_1002_PROTOCOL_ERROR = 1002 ``` ### WS\_1003\_UNSUPPORTED\_DATA `module-attribute` ``` WS_1003_UNSUPPORTED_DATA = 1003 ``` ### WS\_1005\_NO\_STATUS\_RCVD `module-attribute` ``` WS_1005_NO_STATUS_RCVD = 1005 ``` ### WS\_1006\_ABNORMAL\_CLOSURE `module-attribute` ``` WS_1006_ABNORMAL_CLOSURE = 1006 ``` ### WS\_1007\_INVALID\_FRAME\_PAYLOAD\_DATA `module-attribute` ``` WS_1007_INVALID_FRAME_PAYLOAD_DATA = 1007 ``` ### WS\_1008\_POLICY\_VIOLATION `module-attribute` ``` WS_1008_POLICY_VIOLATION = 1008 ``` ### WS\_1009\_MESSAGE\_TOO\_BIG `module-attribute` ``` WS_1009_MESSAGE_TOO_BIG = 1009 ``` ### WS\_1010\_MANDATORY\_EXT `module-attribute` ``` WS_1010_MANDATORY_EXT = 1010 ``` ### WS\_1011\_INTERNAL\_ERROR `module-attribute` ``` WS_1011_INTERNAL_ERROR = 1011 ``` ### WS\_1012\_SERVICE\_RESTART `module-attribute` ``` WS_1012_SERVICE_RESTART = 1012 ``` ### WS\_1013\_TRY\_AGAIN\_LATER `module-attribute` ``` WS_1013_TRY_AGAIN_LATER = 1013 ``` ### WS\_1014\_BAD\_GATEWAY `module-attribute` ``` WS_1014_BAD_GATEWAY = 1014 ``` ### WS\_1015\_TLS\_HANDSHAKE `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.