Skip to content
getgeolens.com
GeoLens DocsEarly release

Login

POST
/auth/login
 
curl --request POST \
  --url https://example.com/api/auth/login \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data grant_type=example \
  --data username=example \
  --data password=example \
  --data scope= \
  --data client_id=example \
  --data client_secret=example

Authenticate with username and password, receive a JWT token.

Request Body required

Section titled “Request Body required ”
Media type application/x-www-form-urlencoded
Body_login_auth_login_post
object
grant_type
Any of:
string
/^password$/
username
required
Username
string
password
required
Password
string format: password
scope
Scope
string
""
client_id
Any of:
string
client_secret
Any of:
string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
TokenResponse
object
access_token
required
Access Token

JWT access token for Authorization header

string
refresh_token
required
Refresh Token

Opaque token used to obtain a new access token

string
token_type
Token Type
string
default: bearer
expires_in
required
Expires In

Seconds until the access token expires

integer
Example 
{
  "token_type": "bearer"
}

400

Section titled “400 ”

Bad request — invalid query parameters or payload

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

403

Section titled “403 ”

Forbidden — caller lacks access to this resource

404

Section titled “404 ”

Not found

422

Section titled “422 ”

Validation error

500

Section titled “500 ”

Internal server error