Welcome to Simplici!

API Guide:

Base Urls:

• Prod: https://api.satschel.com/v2/
• Sandbox/Beta: https://api.beta.satschel.com/v2/

1. Authentication Steps:

To access the Simplici API endpoints, an authentication process is required. Here are the steps:

1.1. Generating Access Token

• Endpoint: /auth/session-tokens

• Method: POST

• Payload:

  JSON

  {
    "client_id": "<YOUR_CLIENT_ID>",
    "client_secret": "<YOUR_CLIENT_SECRET>"
  }
  

• Response Example:

  JSON

  {
    "access_token": "<YOUR_ACCESS_TOKEN>",
    "token_type": "Bearer",
    "refresh_token": "<YOUR_REFRESH_TOKEN>",
    "expires_in": 1695845492
  }
  

  Save the access_token value. This is your token which is required to make further API calls.

1.2. Refreshing the Access Token

In case your token expires, you can use the refresh token to get a new access token.

• Endpoint: /auth/refresh-token

• Method: POST

• Payload:

  JSON

  {
    "client_id": "<YOUR_CLIENT_ID>",
    "refresh_token": "<YOUR_REFRESH_TOKEN>"
  }
  

• Response Example:

  JSON

  {
    "access_token": "<YOUR_NEW_ACCESS_TOKEN>",
    "token_type": "Bearer",
    "refresh_token": "<YOUR_NEW_REFRESH_TOKEN>",
    "expires_in": 1695845563
  }
  

1.3. Verifying Access Token

To ensure that your access token is valid and has not expired:

• Endpoint: /auth/verify

• Method: POST

• Headers:

  JSON

  {
    "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
  }
  

2. API Usage

Once authenticated, you can now use the various APIs provided by Simplici. Use the access token in the Authorization header of your requests.

• Headers for API Calls:

  JSON

  {
    "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
  }
  

For detailed information on all available API endpoints, their methods, parameters, and sample responses, refer to the official Simplici documentation:

• API Reference

Always ensure that you handle your client_id, client_secret, access_token, and refresh_token with care, as they provide access to sensitive data. Avoid exposing them in client-side code or public repositories.