title: Response Status Code
description: Set custom HTTP response status codes in JustAPI handlers.
keywords: [JustAPI, status code, HTTP status, response, error handling]

Default Status Code

JustAPI returns 200 OK by default for successful responses.

Custom Status Code

Use status_code in the decorator:

from justapi import JustAPIApp

app = JustAPIApp()

@app.post("/items", status_code=201)
def create_item():
    return {"message": "created"}

Common Status Codes

Returning a Response Directly

For full control, return a Response object:

from starlette.responses import JSONResponse

@app.get("/custom")
def custom_response():
    return JSONResponse(
        content={"message": "custom"},
        status_code=202,
        headers={"X-Custom": "header"},
    )

See Also

• Handling Errors — exception handlers
• Additional Status Codes — advanced status code patterns
• Status Codes Reference — all available status codes