---
title: "POST /#X-Amz-Target=AmazonForecast.DescribeForecastExportJob"
method: POST
path: "/#X-Amz-Target=AmazonForecast.DescribeForecastExportJob"
---

# POST /#X-Amz-Target=AmazonForecast.DescribeForecastExportJob

`POST /#X-Amz-Target=AmazonForecast.DescribeForecastExportJob`

Describes a forecast export job created using the CreateForecastExportJob operation.

In addition to listing the properties provided by the user in the `CreateForecastExportJob` request, this operation lists the following properties:

*   `CreationTime`
    
*   `LastModificationTime`
    
*   `Status`
    
*   `Message` - If an error occurred, information about the error.

## Headers

- `X-Amz-Target` 'AmazonForecast.DescribeForecastExportJob', required

## Request body

- DescribeForecastExportJobRequest
  - `ForecastExportJobArn` string, required — The Amazon Resource Name (ARN) of the forecast export job.

## Response `200`

Success

- DescribeForecastExportJobResponse
  - `ForecastExportJobArn` string — The ARN of the forecast export job.
  - `ForecastExportJobName` string — The name of the forecast export job.
  - `ForecastArn` string — The Amazon Resource Name (ARN) of the exported forecast.
  - `Destination` object — The path to the Amazon Simple Storage Service (Amazon S3) bucket where the forecast is exported.
    - `S3Config` object, required — The path to an Amazon Simple Storage Service (Amazon S3) bucket along with the credentials to access the bucket.
      - `Path` string, required — The path to an Amazon Simple Storage Service (Amazon S3) bucket or file(s) in an Amazon S3 bucket.
      - `RoleArn` string, required — <p>The ARN of the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket or files. If you provide a value for the <code>KMSKeyArn</code> key, the role must allow access to the key.</p> <p>Passing a role across Amazon Web Services accounts is not allowed. If you pass a role that isn't in your account, you get an <code>InvalidInputException</code> error.</p>
      - `KMSKeyArn` string — The Amazon Resource Name (ARN) of an Key Management Service (KMS) key.
  - `Message` string — If an error occurred, an informational message about the error.
  - `Status` string — <p>The status of the forecast export job. States include:</p> <ul> <li> <p> <code>ACTIVE</code> </p> </li> <li> <p> <code>CREATE_PENDING</code>, <code>CREATE_IN_PROGRESS</code>, <code>CREATE_FAILED</code> </p> </li> <li> <p> <code>CREATE_STOPPING</code>, <code>CREATE_STOPPED</code> </p> </li> <li> <p> <code>DELETE_PENDING</code>, <code>DELETE_IN_PROGRESS</code>, <code>DELETE_FAILED</code> </p> </li> </ul> <note> <p>The <code>Status</code> of the forecast export job must be <code>ACTIVE</code> before you can access the forecast in your S3 bucket.</p> </note>
  - `CreationTime` string, date-time — When the forecast export job was created.
  - `LastModificationTime` string, date-time — <p>The last time the resource was modified. The timestamp depends on the status of the job:</p> <ul> <li> <p> <code>CREATE_PENDING</code> - The <code>CreationTime</code>.</p> </li> <li> <p> <code>CREATE_IN_PROGRESS</code> - The current timestamp.</p> </li> <li> <p> <code>CREATE_STOPPING</code> - The current timestamp.</p> </li> <li> <p> <code>CREATE_STOPPED</code> - When the job stopped.</p> </li> <li> <p> <code>ACTIVE</code> or <code>CREATE_FAILED</code> - When the job finished or failed.</p> </li> </ul>
  - `Format` string — The format of the exported data, CSV or PARQUET.

## Other responses

- `480` — InvalidInputException
- `481` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/forecast.md) · [All operations](https://skmtc.net/aws/apis/forecast/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/forecast/versions/3d1c872d2ac9/schema)