Jobs Endpoint

Overview

This endpoint allows the consumer to download the data file generated for a completed data loader job (from either a FullData or an IncrementalData operation).

There are two ways to obtain the download link for a job:

• Via the status endpoint — once the job is complete, a request to the GET .../status endpoint (for FullData or IncrementalData) includes the download link in the response body.
• Directly via this endpoint — using the job’s id, once the job’s status is Completed.

Base URL

https://data.youforce.com/data/v1/jobs

Authentication

All requests require a Bearer token in the Authorization header.

Important Considerations

• If the resulting data contains zero records, an empty file is still created and can be downloaded.
• The file is stored in our systems for 24 hours after the job completes. After this time, it is automatically deleted. The exact deletion date and time is provided in the expirationDate field returned by the status endpoint.
• The response includes an X-Content-MD5 header containing the MD5 hash of the file. Use this to validate that the downloaded file is complete and was not corrupted in transit.
• Each AppId/client can have a maximum of 25 file downloads in progress at the same time. Exceeding this limit returns 429 Too Many Requests. If this happens, wait until the number of in-progress downloads drops below the limit before retrying.

Developer tips

• Monitor operation status and download each file as soon as its individual job status becomes Completed — don’t wait for all jobs in the operation to complete before starting downloads.
• Processing completed files immediately helps you avoid hitting the AppId download limit and improves overall throughput.
• Keep track of how many downloads you have in progress at any given time, especially when an operation contains many jobs (one per entity).

Endpoint

Download a job file

GET /data/v1/jobs/{jobId}

Parameters

Request example

curl --location 'https://data.youforce.com/data/v1/jobs/8a1c7cba-cbf4-43b5-9e9b-dbcb7ebb5543' \
--header 'Authorization: Bearer abc'

Response

200 OK — the file content in the requested format (csv or json), with the following response header:

Error responses

Summary of Key Behaviors