API Overview

1 minute read

The ServiceChannel API is a RESTful and stateless API. It has predictable, resource-oriented URLs and accepts POST, GET, PUT, and DELETE requests. Our API uses standard HTTP response codes and returns JSON-encapsulated data.

API Version

The current stable version of the ServiceChannel API is v3.

Environments

There are two environments for working with our API: Sandbox2 for testing and Production for live integrations.

App Registration

To use our API, you should have a ServiceChannel account with Super Admin or Provider Admin role. You also need to register your application.

Authentication and Authorization

We use the OAuth 2.0 protocol for simple, yet secure and effective authentication and authorization.

You must include the Authorization header in every API request. Unauthorized calls will fail.

Requests and Responses

Making requests is easy: our API accepts the most common HTTP verbs and has well-structured endpoint routes.

After a successful request, you will receive a JSON-formatted response as well as a standard HTTP status code.

Call Limits

There are limits to how many calls you can make in a minute. See Throttling for the default limit values.

Sandbox Mode

Before going live, thoroughly test and debug your applications in the Sandbox Mode.

You can use your favorite REST client to explore our API, but we recommend the built-in Swagger Explorer, Postman, or Fiddler.

Updated: