---
title: "Fetch reports generation job"
method: GET
path: "/api/v1/reports-generation-jobs/{id}"
tags: ["BETA", "General.Reports Generation Jobs"]
---

# Fetch reports generation job

`GET /api/v1/reports-generation-jobs/{id}`

Fetch reports generation job

## Path parameters

- `id` string, required

## Response `200`

Successful.

- ReportsGenerationJob — Reports generation job describing the status of the triggered reports.
  - `createdTime` string, required — Time of job creation in ISO-8601 format (UTC).
  - `error` string — If an error occurred during job processing this will contain the error message. This is a free-form text and it is not supposed to be parsed programmatically.
  - `id` string, required — An unique identifier of the job.
  - `reports` Report[], required — List of reports triggered by the job.
    - `error` string — If an error occurred during report generation this will contain the error message. This is a free-form text and it is not supposed to be parsed programmatically.
    - `id` string, required — An unique identifier of the triggered report. Always returned, even for reports that failed to be created. Check status before fetching report to know what to expect in the response from the report api.
    - `status` 'PENDING, FAILED, PRECONDITION_FAILED, COMPLETED', required — Status of the report. PENDING: Report creation in progress. FAILED: Report creation failed. PRECONDITION_FAILED: Not enough data to generate a successful report. COMPLETED: Successfully created report.
    - `type` string, required — Report type.
  - `status` 'PENDING, TEMPORARY_ERROR, PERMANENT_ERROR, COMPLETED', required — Status of the job. TEMPORARY_ERROR status indicates that the reports generation may be retried at a later time. PERMANENT_ERROR status indicates that an non-retryable error has occurred and support should be contacted. COMPLETED status indicates that a job had completed successfully. This does not mean that all reports were successfully generated. Any (or even all) triggered reports might have failed and still the job itself might be in COMPLETED state.
  - `updatedTime` string, required — Time when the job status was last updated in ISO-8601 format (UTC).

## Other responses

- `401` — Unauthorized request.
- `403` — Permission denied.
- `404` — Reports generation job with requested ID was not found.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)