results
Retrieve download file URLs for completed download requests.
curl -X GET "https://api.datafiniti.co/v3/results/123" \
-H "Content-Type: application/json" \
-H "Authorization: Basic YOUR_CREDENTIALS"
import requests
import json
url = "https://api.datafiniti.co/v3/results/123"
headers = {
"Content-Type": "application/json",
"Authorization": "Basic YOUR_CREDENTIALS"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.datafiniti.co/v3/results/123", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Basic YOUR_CREDENTIALS"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
)
func main() {
req, err := http.NewRequest("GET", "https://api.datafiniti.co/v3/results/123", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Basic YOUR_CREDENTIALS")
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/v3/results/123')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Basic YOUR_CREDENTIALS'
response = http.request(request)
puts response.body
[{
"id": 1,
"url": "https://datafiniti-downloads.s3.amazonaws.com/15/7_1.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&...",
"request_id": 6073,
"downloaded": 42,
"imported": 42,
"date_created": "2017-1-11 15:53:00"
}]
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/results/{request_id}Username for basic authentication
Password for basic authentication
The unique ID of the download request whose results you want to retrieve
Request Preview
Response
Response will appear here after sending the request
Authentication
Basic authentication credentials. V3 uses Basic Authentication with your API token as the username and no password. In URL form: https://YOUR_API_TOKEN:@api.datafiniti.co/v3/... In cURL: --user YOUR_API_TOKEN: (note the trailing colon). Get your token from the Datafiniti Web Portal at https://portal.datafiniti.co.
Path Parameters
The unique ID of the download request whose results you want to retrieve
Responses
Unique identifier for the result object
The URL of the data file. Fetch the content of this URL to download the file. This is typically an S3 pre-signed URL.
A unique identifier for your download request
An internal field. You can ignore this.
An internal field. You can ignore this.
Date the result file was created. The result file will expire 7 days after this date.
Error message describing what went wrong
Results don't exist. If your download request status still says STARTED, wait until it says COMPLETED. You may also be using the wrong request ID.
You may be trying to look at an invalid request ID.
The results endpoint lets you view the URLs of available data files for your completed download. Each result object contains a URL where you can download the data file. Result files expire 7 days after creation.
Last updated Mar 4, 2026
Built with Documentation.AI