Requesting Dataresults

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"
[{
  "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"
}]
GET
/results/{request_id}
GET
Basic Authentication
Usernamestring
Required

Username for basic authentication

Passwordpassword
Required

Password for basic authentication

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
request_idinteger
Required

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

header
Authorizationstring
Required

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

request_idinteger
Required

The unique ID of the download request whose results you want to retrieve

Responses

idinteger

Unique identifier for the result object

urlstring

The URL of the data file. Fetch the content of this URL to download the file. This is typically an S3 pre-signed URL.

request_idinteger

A unique identifier for your download request

downloadedinteger

An internal field. You can ignore this.

importedinteger

An internal field. You can ignore this.

date_createdstring

Date the result file was created. The result file will expire 7 days after this date.

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.