Authenticate user

POST

/authenticate/

After you have authenticated you can use the token to make subsequent requests to the api.
For making an authenticated request add authorization header to each request, e.g. Authorization: Token {{token}}

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

The request has succeeded.

Body

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/authenticate/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "string",
    "password": "string",
    "otp": "string"
}'

Response Example

{
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "username": "string",
    "user_display_name": "string",
    "role": "string",
    "merchant_id": "500924a8-3f5e-4c00-beb8-2efcde988aea",
    "merchant_role": "admin",
    "token": "b5507016-7da2-4777-a161-1e8042a6a377",
    "kyc_level": "no-level"
}

Modified at 2025-06-30 14:21:47

Add invoice