Skip to content

# Form data

Django Ninja also allows you to parse and validate `request.POST` data (aka `application/x-www-form-urlencoded` or `multipart/form-data`).

## Form Data as params

    from ninja import NinjaAPI, Form

    @api.post("/login")
    def login(request, username: Form[str], password: Form[str]):
        return {'username': username, 'password': '*****'}

Note the following:

1) You need to import the `Form` class from `ninja`

    from ninja import Form

2) Use `Form` as default value for your parameter:

    username: Form[str]

## Using a Schema

In a similar manner to Body, you can use a Schema to organize your parameters.

## Request form + path + query parameters

In a similar manner to Body, you can use Form data in combination with other parameter sources.

You can declare query and path and form field, and etc... parameters at the same time.

Django Ninja will recognize that the function parameters that match path parameters should be taken from the path, and that function parameters that are declared with `Form(...)` should be taken from the request form fields, etc.

## Mapping Empty Form Field to Default

Form fields that are optional, are often sent with an empty value. This value is interpreted as an empty string, and thus may fail validation for fields such as `int` or `bool`.

This can be fixed, as described in the Pydantic docs, by using Generic Classes as Types.