API overview

The API is an interface that allows users to interact programmatically with the Matillion Data Productivity Cloud.

The API follows a RESTful architecture, which is characterized by several key attributes:

A resource based URL format.
When interacting with the API use form encoded data.
Response from the API is in JSON format.
The Matillion API uses HTTP response codes.
The API employs standard authentication methods, including the use of bearer tokens, to secure access. It also follows standard HTTP verbs (e.g. GET, POST, PATCH, and DELETE) for consistent and familiar interaction with the API.

Before you begin

Create a Hub account or sign in.

Base URL

EU server:

https://eu1.api.matillion.com/dpc

US server:

https://us1.api.matillion.com/dpc

Note

Make sure to choose the right endpoint when you are using the console. Your Hub account needs to be in the same region as the endpoint server.

Authentication

The Data Productivity Cloud API supports Bearer token authentication. To authenticate with the API endpoint, you should provide a token obtained through API credentials created in your Hub account.

For detailed instructions on the authentication process, read authentication.

Rate limits

The API has a fixed rate limit, which may cause errors if you attempt a large number of concurrent endpoint calls.

The rate limit is configured as follows:

Burst: 5
Average: 60

If you receive a rate limit error from the API, try reconfiguring your scripts or pipelines to make use of sequential endpoint calls. In a Data Productivity Cloud pipeline calling the API, consider including a Retry component with the Retry delay property set to Short delay with backoff.