V1 Get Token REST Service for OAuth Authentication

GET /ws/rest/service/v1/oauth/token

Version: 21.7

Purpose

Use this REST service to generate an OAuth token to access V1 REST services.

Authorization

Use the OAuth type integration user and password reset using email.

Input Authorization

Username and password using Basic Authentication

All parameters should be URL encoded.

curl --location 'http://<HOST>/ws/rest/service/v1/oauth/token' \

--header 'Authorization: Basic XYZ'

Optional Request Parameter

Use the following parameter to modify the token expiration in the API request:

Request Parameter

Data Type

Description

expiry

string

Enter the optional token expiration duration in seconds. For example, expiry=300. The default value is 3600 seconds.

Response Format

A JSON object is returned containing 'status', 'data', and 'message'.

For a successful status (status code 200), the token details will be sent in the JSON output response.

If the status is not a success, a JSON object containing a 'message' is returned.

Sample Response

{

"access_token": "eyJ4NXQjUzI1NiIdds6IkRoQXRBNENzTDRUdEIza1BLRlY3TTZSUzlCbExBamIxbDBvV2V6OXpaUXMiLCJ4NXQiOiJXMlR2WXlBeTZZTEpUSndBRC1YdENRRXFmbnMiLCJraWQiOiJTSUdOSU5HX0tFWSIsImFsZyI6IlJTMjU2In0.eyJ1c2VyX3R6IjoiQW1lcmljYVwvQ2hpY2FnbyIsInN1YiI6Imp5b3RoaS5nYXR0dUBvcmFjbGUuY29tIiwidXNlcl9sb2NhbGUiOiJlbiIsInVzZXIudGVuYW50Lm5hbWUiOiJpZGNzLWM5YWFkYjYwZmJhMjRhN2RiYTU2N2NiZGM4NDRmYjUxIiwiaXNzIjoiaHR0cHM6XC9cL2lkZW50aXR5Lm9yYWNsZWNsb3VkLmNvbVwvIiwidXNlcl90ZW5hbnRuYW1lIjoiaWRjcy1jOWFhZGI2MGZiYTI0YTdkYmE1NjdjYmRjODQ0ZmI1MSIsImNsaWVudF9pZCI6IjlhZmI3MmY5OWFjMTQ1ZmY5MWUwYmEyMTg2ZjA3M2U5Iiwic3ViX3R5cGUiOiJ1c2VyIiwic2NvcGUiOiJ1cm46b3BjOmlkbTp0LnNlY3VyaXR5LmNsaWVudCIsImNsaWVudF90ZW5hbnRuYW1lIjoiaWRjcy1jOWFhZGI2MGZiYTI0YTdkYmE1NjdjYmRjODQ0ZmI1MSIsInJlZ2lvbl9uYW1lIjoidXMtYXNoYnVybi0xIiwidXNlcl9sYW5nIjoiZW4iLCJ1c2VyQXBwUm9sZXMiOlsiQXV0aGVudGljYXRlZCJdLCJleHAiOjE2MTk1OTQ5NTAsImlhdCI6MTYxOTU5NDc1MCwiY2xpZW50X2d1aWQiOiIxOGEwOGY4MTdiODM0ODllODc2M2FmMDYwYjEyNjdhYiIsImNsaWVudF9uYW1lIjoiSnlvdGhpVW5pZmllcl9SZXNvdXJjZUdyYW50IiwidGVuYW50IjoiaWRjcy1jOWFhZGI2MGZiYTI0YTdkYmE1NjdjYmRjODQ0ZmI1MSIsImp0aSI6IjExZWJhN2YyZjU4ZDYzMzRhYjM5YmZjNWM3ZmQyZjllIiwiZ3RwIjoicm8iLCJ1c2VyX2Rpc3BsYXluYW1lIjoiSnlvdGhpIEdhdHR1Iiwic3ViX21hcHBpbmdhdHRyIjoidXNlck5hbWUiLCJwcmltVGVuYW50Ijp0cnVlLCJ0b2tfdHlwZSI6IkFUIiwiY2FfZ3VpZCI6ImNhY2N0LWI2MWUxZmMyMjlkNTQ2ZDg4ODQ0NGMxMWE3ZTIzNzgwIiwiYXVkIjpbImh0dHBzOlwvXC9pZGNzLWM5YWFkYjYwZmJhMjRhN2RiYTU2N2NiZGM4NDRmYjUxLmlkZW50aXR5LmM5ZGV2Mi5vYzlxYWRldi5jb20iLCJodHRwczpcL1wvaWRjcy1jOWFhZGI2MGZiYTI0YTdkYmE1NjdjYmRjODQ0ZmI1MS51cy1hc2hidXJuLTEuc2VjdXJlLmlkZW50aXR5LmM5ZGV2Mi5vYzlxYWRldi5jb20iLCJ1cm46b3BjOmxiYWFzOmxvZ2ljYWxndWlkPWlkY3MtYzlhYWRiNjBmYmEyNGE3ZGJhNTY3Y2JkYzg0NGZiNTEiXSwidXNlcl9pZCI6Ijg2ZWMxNTE2MDUyYjRlNGI4ZTRkZDVjYzJhNDA2NGQ0IiwiY2xpZW50QXBwUm9sZXMiOlsiQXV0aGVudGljYXRlZCBDbGllbnQiXSwidGVuYW50X2lzcyI6Imh0dHBzOlwvXC9pZGNzLWM5YWFkYjYwZmJhMjRhN2RiYTU2N2NiZGM4NDRmYjUxLmlkZW50aXR5LmM5ZGV2Mi5vYzlxYWRldi5jb206NDQzIn0.exvW4qPZDf6oGJKp71ZNggSLZ44G4dKS5f53QfeTp1HDzldili0PdETspZxyDA1IkhVzTFfMjFI1-V6MOTPHMxplMiMXC3gGA_23_p-ZLEVTssub09NeIx3CCuOraIS1lo8c3T5W8x_H_ZQyHYyOnr8FGMczwbvSZZ0Iwlcusf9DLUFxAWnBq25y0FfJ2z6S8TthZqRo6vo0_PqtkuiskmG6Ig48JW2m038jfIsrve7ZYAoB-eWAGE5xfuVkYwD4s5mtDQnNldQpsoOQilSGBb51s_KxSAv5mbvmeHg8omVHTHtOmVfDXfEbVlZE5ccdSy5w_yWT3Egxv-uFxo8MLdiQ",

"token_type": "Bearer",

"expires_in": 3600,

"status": 200

}



Last Published Tuesday, July 1, 2025