Report Export
Asynchronously export reports through impact.com's Jobs system. Recommended for all report downloads.
Schedules a report to be exported asynchronously through impact.com's Jobs system. Returns immediately with the initial job status and three URIs to interact with the job.
Use the returned QueuedUri to poll job status, ResultUri to download the result file once the job has completed, and ReplayUri to re-run the same job.
Available query parameters
ResultFormat— output file format (universal).Report-specific filters — every report accepts its own set of filter parameters (
START_DATE,END_DATE,SUBAID,Advertiser, etc.). CallGET /Reports/{ReportId}/MetaDatafirst to discover which filters a given report supports.
Error handling
Invalid input is returned as HTTP 200 with an error envelope in the body — for example, an unknown ReportId returns {"Status":"ERROR","Message":"Not permitted to run report ..."}. Always check the Status field before treating the response as a queued job.
Your Agency Account SID.
IRvgRXbtVxiB1020978HSjRGWssUVwEtj1The unique ID of the report to export. Use GET /Reports to list all reports and find each report's Id.
agency_action_listingThe file format the exported report should be returned in.
CSVExample: CSVPossible values: The start date (inclusive) for the report data, in YYYY-MM-DD format. Required by most reports — check the report's MetaData to confirm.
2026-05-01The end date (inclusive) for the report data, in YYYY-MM-DD format. Required by most reports — check the report's MetaData to confirm.
2026-05-29A program (campaign) ID to refine the report to data from a single program. Required for some reports.
12345Success — the export job was queued. Response includes URIs for polling and downloading the result.
Error — invalid input (e.g., bad ReportId, unrecognised ResultFormat, invalid date) returns the same HTTP 200 status with an error envelope. See the ErrorResponse schema and the operation description.
Job-handle response returned from the ReportExport endpoint. The export runs asynchronously through impact.com's Jobs system; use the URIs in this response to track and retrieve the result.
On invalid input the API returns the same HTTP 200 with an ErrorResponse envelope instead — check the Status field.
The initial status of the export job. Returns QUEUED on successful submission, or ERROR if the request was invalid (in which case a Message field will be populated instead of the URIs).
QUEUEDPossible values: The relative URI of the underlying job. Use it (or its trailing job ID) with the Jobs API to poll for status updates.
/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12The relative URI to download the exported result file. Available once the job completes — calling it before completion returns the job status, not the file.
/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12/DownloadThe relative URI to re-run the same export with the same parameters. Useful for retrying failed jobs without re-specifying inputs.
/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12/ReplayA human-readable error description. Only present when Status is ERROR.
Not permitted to run report nonexistent_reportUnauthorized. Check that your Account SID and Auth Token are correct.
curl -L \
--url 'https://api.impact.com/Agencies/{AccountSID}/ReportExport/{ReportId}' \
--user '{AccountSID}:{AuthToken}' \
--header 'Accept: */*'{
"Status": "QUEUED",
"QueuedUri": "/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12",
"ResultUri": "/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12/Download",
"ReplayUri": "/Agencies/IRvgRXbtVxiB1020978HSjRGWssUVwEtj1/Jobs/8ef45463-8b0b-499f-8cdc-8d6e4c2a8c12/Replay"
}Last updated

