Seamless API (1.0.0)

1. Register Your Application

To use the Seamless API, you need to register your application to obtain an API key. To create a new API key, go to Seamless.AI | Settings > API Key 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.

2. Use the Access Token

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

Token: API_KEY

1. Register Your Application

Before integrating, you have to setup your client credentials.

To create a new API client, go to Seamless.AI | Settings > OAuth 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. If your redirect_uri contains any query parameters (such as ?foo=bar), you must URL encode your redirect_uri for this step.

---

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 and remaining credits 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.
X-PublicAPI-Credits	1000	The number of credits remaining that can be used in requests.