Progress of an asynchronous report
GET /api/marketing/insights/reports/{reportRunId}async_status goes from Job Not Started to Job Completed (or Job Failed) and async_percent_completion from 0 to 100. error_code and error_message only come if Meta failed the report. A report older than 30 days no longer exists on Meta’s side and answers the corresponding error. Requires the marketing:read scope.
Responses
Section titled “Responses”| Status | Description | Schema |
|---|---|---|
200 | — | InsightsReportRunDto |
Example
Section titled “Example”curl -X GET https://api.neike.dev/api/marketing/insights/reports/{reportRunId} \ -H "x-neike-api-key: whk_live_…"InsightsReportRunDto
Section titled “InsightsReportRunDto”| Field | Type | Description | |
|---|---|---|---|
report_run_id | string | required | Report id. It expires after 30 days. |
async_status | string | required | Job Not Started, Job Started, Job Running, Job Completed, Job Failed… |
async_percent_completion | number | required | 0 a 100. |
error_code | number | required | — |
error_message | string | required | — |