Skip to main content
POST
/
v1
/
exports
Create export
curl --request POST \
  --url https://api.trydatadriver.com/v1/exports
import requests

url = "https://api.trydatadriver.com/v1/exports"

response = requests.post(url)

print(response.text)
const options = {method: 'POST'};

fetch('https://api.trydatadriver.com/v1/exports', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.trydatadriver.com/v1/exports",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.trydatadriver.com/v1/exports"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.trydatadriver.com/v1/exports")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.trydatadriver.com/v1/exports")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

​
When you’d use this

When the result set is too big to page through with /search — say, 50,000+ rows. Instead of looping for hours, you ask us to build a file in the background, then download it from a signed URL.

​
Headers

HeaderRequired?Description
AuthorizationyesBearer token.
Content-Typeyesapplication/json
Idempotency-KeyrecommendedAny string you choose. Sending the same key within 24h returns the same export_id instead of creating a duplicate.

​
Request body

FieldTypeDescription
table (required)stringWhich table to export from.
select (optional)arrayColumns. Use ["*"] for all.
filters (optional)objectSame shape as /search filters.
format (optional)stringcsv (default) or jsonl.
compression (optional)stringgzip (default) or none.

​
Request

curl https://api.trydatadriver.com/v1/exports \
  -H "Authorization: Bearer dd_a3f9b2c1d4e5f6g7h8i9j0" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: az-tier1-2026-05-09" \
  -d '{
    "table": "leads",
    "select": ["*"],
    "filters": {
      "state": { "in": ["AZ"] },
      "tier":  { "eq": 1 },
      "dnc":   { "eq": "N" }
    },
    "format":      "csv",
    "compression": "gzip"
  }'

​
Response

{
  "export_id":  "exp_a3f9b2c1d4e5f6g7",
  "status":     "pending",
  "created_at": "2026-05-09T12:14:00Z",
  "poll_url":   "https://api.trydatadriver.com/v1/exports/exp_a3f9b2c1d4e5f6g7"
}
It’s not done yet. 202 Accepted means “working on it.” Poll GET /v1/exports/{id} until status becomes completed.
If you sent an Idempotency-Key and it matches a recent export, the response will include "idempotent_replay": true and the same export_id as before — no new export was created.