User login with email and password

POST

https://app.gotreek.com/api/auth/login

Authentication

Last modified:2025-12-25 07:54:10

💡

Authenticate a user with email and password to get a Bearer token for API access. The token can be used to access merchant APIs and other user-specific endpoints. Access is scoped based on the user's role (admin vs merchant).

💡

Detailed description

This endpoint validates the provided email and password combination against the user database.

If the credentials are valid, the server internally calls the OAuth token endpoint to generate an access token (password grant type) and returns that token to the client.

If the credentials are invalid or if the OAuth client is not properly configured, the endpoint returns a structured JSON error response with an appropriate HTTP status code

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Body

🟠401

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.gotreek.com/api/auth/login' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "test",
    "password": "test"
}'

Response Example

200 - Success

{
    "token_type": "Bearer",
    "expires_in": 86400,
    "access_token": "_acces_token_",
    "refresh_token": "_refresh_token_"
}

Modified at 2025-12-25 07:54:10

Create Order