The Federated Tables API allows you to perform live queries to a remote database.

This component is still under support but it will not be further developed. We don’t recommend starting new projects with it as it will eventually become deprecated. Instead, learn more about our new APIs here

Warning: Federated Tables is in BETA stage and the API might change or have limited support.

General Concepts

The following concepts are the same for every endpoint in the API except when it is noted explicitly.


Manipulating data on a CARTO account requires prior authentication using a unique identifier as a password. For the federated tables API, a special identifier known as the API Key is used as a proof of authentication for each user account to authorize access to its data.

To execute an authorized request, api_key=YOURAPIKEY should be added to the request URL. This parameter can be also passed as a POST parameter. We strongly advise using HTTPS when you are performing requests that include your api_key.


Errors are reported using standard HTTP codes.