Authentication

Before you can get started with the integration, client credentials are required to obtain JWT authentication tokens. Grapes API calls without the JWT authentication token will fail.

Please send us a request here to get access to the developer's sandbox.

Testing Authentication

TO verify your client credentials are set up correctly, run the command below which will allow you to fetch JWT tokens.

# Replace ${client_id} & ${client_secret}
# with your organization's client credentials
{
  "audience": "https://api.staging.grapesfinance.com/v1",
  "client_id": "${client_id}",
  "client_secret": "${client_secret}",
  "grant_type": "client_credentials"
}

👍 Successful Response

{
  "access_token": "eyJraWQiOiJpalVBdG5COGdpQXc0SVBzbThhRW91KzFSVzhRRkVDWEI5OVVTTUM1REZRPSIsImFsZyI6IlJTMjU2In0.eyJzdWIiOiI3cGtyYTZzMzJrMHNlMTltY2w5OGhrajNlZCIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiaHR0cHM6XC9cL2FwaS5zdGFnaW5nLmdyYXBlc2ZpbmFuY2UuY29tXC92MSIsImF1dGhfdGltZSI6MTcyMzQ3NjM5NSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMi5hbWF6b25hd3MuY29tXC91cy1lYXN0LTJfZndId1FudG05IiwiZXhwIjoxNzIzNTYyNzk1LCJpYXQiOjE3MjM0NzYzOTUsInZlcnNpb24iOjIsImp0aSI6ImJkODY1MWI1LTgzNGItNDA1MS05ZjAwLWYzY2ZiMGQ0ZDgxMCIsImNsaWVudF9pZCI6Ijdwa3JhNnMzMmswc2UxOW1jbDk4aGtqM2VkIn0.qi5BUGrK9WBjHiG2kNbrS9NtnlmNuD_H6dfGI7rudYAhLlBtgTZQYXmx78-IA61m234W1HmdHVnFOTfHtaQomVRFHN-pYTUgsmctC7dPrTTyo8WB3d75FsC0ND0TrW80kk6pCmRTKaK58F58AuvFobDsRSM4CalCWfwf42nZ6t1PUkexb13f51D6qlAJfwzd-uKeeWdDP1CV-hITwzBDKJiJB13Mo0pZTMN2Hgp-Cfz0yyXaMgZlUlPQW3z9TdPmE0rqXj8dzsIyhFl29Fl3hyp7-bhxWFEWVL4xUdux2ibBOLD-z1Whu_BgUiSbWpTozB9zYjCy1u4vOkwnxVC-9g",
  "expires_in": 86400,
  "token_type": "Bearer"
}

❗ Error Response

{
    "message": "Unauthorized",
    "statusCode": 401
}