Cancel a Download
Cancel an in-progress download. Cancelled downloads retain records added before cancellation.
curl -X DELETE "https://api.datafiniti.co/v4/downloads/example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://api.datafiniti.co/v4/downloads/example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.delete(url, headers=headers)
print(response.json())
const response = await fetch("https://api.datafiniti.co/v4/downloads/example_string", {
method: "DELETE",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api.datafiniti.co/v4/downloads/example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.datafiniti.co/v4/downloads/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"message": "example_string"
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
/downloads/{id}Bearer token obtained from the /auth endpoint. Include in requests as: Authorization: Bearer <token>
The unique identifier of the download to cancel
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Bearer token obtained from the /auth endpoint. Include in requests as: Authorization: Bearer <token>
Path Parameters
The unique identifier of the download to cancel
Responses
Confirmation message
Error message describing what went wrong
Cancelling a download will stop the download, but not delete it. It will still include all records that were added to the download before it was cancelled, and you will be able to retrieve these records still, through GET /downloads/{id}.
Your account will still have credits deducted for the number of records that were added before the download was cancelled.
Last updated Mar 26, 2026
Built with Documentation.AI