Authorization

Authorization

Your client application should use your client credentials to request an access token from the Business API auth endpoint. Other endpoints require an access token to get or manipulate data.

Authorization request params:

NameDescription
URLhttps://business-api.gett.com/oauth/token
client_idClient_id issued in Settings - Integrations setup
client_secretClient_secret issued in Settings - Integrations setup
grant_typeclient_credentials
scopefinance

To issue Client ID, Client Secret and get Business_id you need to visit Settings - Integrations setup in web portal with admin role. Ensure you're set as Contact in Settings.

Request example

Parameters:

curl -s 'https://business-api.gett.com/oauth/token' \
-F 'grant_type=client_credentials' /
-F 'client_id=92e0b95a-8690-4c26-b45b-5465af3a1bd7.13d08230-15ba-4016-9b6f-a4f495f80fe1' \
-F 'client_secret=my_secret_from_gett' \
-F 'scope=finance'

Response

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6InByaW1hcnkta2V5IiwidHlwIjoiSldUIn0.eyJhdWQiOltdLCJleHAiOjE2MTI3NzQ3ODUsImlhdCI6MTYxMjc3Mzg4NSwiaWRlbnRpZmllciI6ImUxZDVhNDgwLWZlYzEtNDk1ZS1hOWNkLTkzZTZhY2Q4MWM4OCIsImlzcyI6Imh0dHBzOi8vZ2xvYmFsLWF1dGguZ2V0dC5jb20iLCJqdGkiOiJiZTI2NWIyZC0zZTA2LTQ1Y2EtODE5Ni1jNzliMjg5OGYzNjEiLCJuYmYiOjE2MTI3NzM4ODUsInJlc291cmNlX3V1aWQiOiI5MmUwYjk1YS04NjkwLTRjMjYtYjQ1Yi01NDY1YWYzYTFiZDciLCJzY3AiOlsiY29tcGFueS5yZWZlcmVuY2UiLCJvcmRlciJdLCJzdWIiOiI5MmUwYjk1YS04NjkwLTRjMjYtYjQ1Yi01NDY1YWYzYTFiZDcuMTNkMDgyMzAtMTViYS00MDE2LTliNmYtYTRmNDk1ZjgwZmUxIn0.n-ECwfFkVZJJILip3xXf8rEHxAH-0Q42iFfwTeeiiqlwv5Xt5Etq34--EoM43Oxa3xyVQfDQTXwX3-vQQ_ojNcR0hTL1iK34AwHgbCzx-THf02oQydxTrN9oZo9dqp0XjvPbsUF_db3S3HUjIJhqhJwg_1Ll8VSMGJcBVM7hqrzfeqFlq0N6M3VCBAr_jH73Nxd_1jv-VxRRFmLHan6qYOjxpXVswLxfKzGyBL__JbJ82IzycnDKCus5v3BbJuS-rMml13R-VYt8EzCdFD9JYjmpuyUQHxL7fl5MX5Ok_VbH9NZHOw0hCkCwwAjAfR2F2Wc2t1Mh5002RRGzE8d3KQ",
  "expires_in": 899,
  "scope": "finance",
  "token_type": "bearer"
}

What’s Next