Skip to main content
POST
/
v1
/
auth
Session Token 
curl --request POST \
  --url https://scx-sbx.api.jtl-software.com/v1/auth \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data refreshToken=SELLER:0eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ
{
  "scope": "SELLER",
  "authToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ.uWKi0yGrf35hapLiNAb1QHpQ5dLJ7hyUg8_R6GU6RzU",
  "tokenExpireAt": "2036-04-01T12:00:00+00:00",
  "expiresIn": 360
}

Body

application/x-www-form-urlencoded

Refresh token used to obtain a new short-lived session (access) token.

​
refreshToken
string
Example:

"SELLER:0eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ"

Response

Create new Auth Token

Issued session credentials returned by the auth endpoint. Contains the bearer token, its scope (seller, channel, or admin), and absolute/relative expiry timestamps.

​
scope
enum<string>
Available options:
SELLER,
CHAN,
ADM
Example:

"SELLER"

​
authToken
string
Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ.uWKi0yGrf35hapLiNAb1QHpQ5dLJ7hyUg8_R6GU6RzU"

​
tokenExpireAt
string<date-time>
Example:

"2036-04-01T12:00:00+00:00"

​
expiresIn
integer
Example:

360