Introduction

Get started with the Datafold REST API. Learn how to authenticate, obtain an API key, and make your first API call.

Our REST API allows you to interact with Datafold programmatically. To use it, you’ll need an API key. Follow the instructions below to get started.

​

Create an API Key

Open the Datafold app, visit Settings > Account > API keys, and select Create API Key.

Store your API key somewhere safe. If you lose it, you’ll need to generate a new one.

For pipelines, scheduled jobs, scripts, and other automation, prefer a service account over a personal API key. Service accounts are machine identities owned by your organization — they survive when the original creator leaves the team and can hold many more keys (50 vs. 5 per human user).

​

Use your API Key

When making requests to the Datafold API, you’ll need to include the API key as a header in your HTTP request for authentication. The header should be named Authorization, and the value should be in the format:

Authorization: Key {API_KEY}

For example, if you’re using cURL:

curl https://us.datafold.com/api/v1/... -H "Authorization: Key {API_KEY}"

​

Base URL

Send requests to the host you use to log in to Datafold:

Deployment	Base URL
US multi-tenant	https://us.datafold.com
EU multi-tenant	https://eub.datafold.com
Dedicated or customer-hosted	Your deployment’s own domain

The examples in this reference use https://us.datafold.com. The same host applies to the MCP server endpoint (/mcp/).

If you use Datafold Classic (app.datafold.com or eu.datafold.com), see the Classic API reference.

If your organization’s trial period has ended, API keys stop authenticating and requests return 401 Unauthorized. Contact [e-mail] to extend access.

​

Need help?

If you have any questions about how to use our REST API, please reach out to our team via Slack, in-app chat, or email us at [e-mail].