Seamless API (1.0.0)

1. Register Your Application

Before integrating, you have to setup your client credentials.

To create a new API client, go to Seamless.AI | Settings > Public API Connections, and click the Create New Connection button.

Note: The Public API Connections menu will only appear if your account has access to the Public API.

• client_id
• client_secret
• redirect_uri

You’ll use these to authenticate and obtain tokens.

---

2. Obtain Authorization Code

Redirect the user to Seamless.AI's OAuth authorization endpoint:

GET https://login.seamless.ai/oauth/authorize

Query Parameters:

Name	Description
client_id	Your client ID
redirect_uri	The URL users are redirected to
state	(Optional) CSRF protection string

Example URL:

GET https://login.seamless.ai/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=https://yourapp.com/callback

Once the user authenticates, they will be redirected to your redirect_uri with a code parameter.

---

3. Exchange Code for Access Token

POST https://api.seamless.ai/api/client/v1/oauth/accessToken

Request Body (JSON):

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "redirect_uri": "https://yourapp.com/callback",
  "grant_type": "authorization_code",
  "code": "AUTHORIZATION_CODE_FROM_STEP_2"
}

Response:

{
  "access_token": "ACCESS_TOKEN",
  "refresh_token": "REFRESH_TOKEN",
  "expires_at": 1712000000
}

---

4. Use the Access Token

For all authenticated API requests, include the token in the header:

Authorization: Bearer ACCESS_TOKEN

---

5. Refreshing the Token

To refresh the access token:

POST https://api.seamless.ai/api/client/v1/oauth/accessToken

Request Body:

{
  "client_Id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "redirect_uri": "https://yourapp.com/callback",
  "grant_type": "refresh_token",
  "refresh_token": "YOUR_REFRESH_TOKEN"
}

The limit is currently around 100 requests per 60 seconds per Endpoint. You will receive a 429 HTTP response if you exceed the rate limit.

Rate limit information will be returned in the response header of each request. The parameters are:

Name	Example	Description
X-RateLimit-Limit	100	The maximum number of requests you're permitted to make in a given time period.
X-RateLimit-Remaining	55	The number of requests remaining in the current rate limit window.
X-RateLimit-Reset	1745587198	The time at which the current rate limit window resets in epoch seconds.