---
title: "Fetch the status report for a single job"
method: GET
path: "/{custNr}/fax/reports/{jobId}"
tags: ["Fax reports"]
---

# Fetch the status report for a single job

`GET /{custNr}/fax/reports/{jobId}`

## Request

- Base URL: `https://faxws.de1.retarus.com/rest/v1`
- URL: `https://faxws.de1.retarus.com/rest/v1/{custNr}/fax/reports/{jobId}`
- Auth: HTTP basic

With the assistance of this URL resource, a status report for a fax job
can be requested by jobId.

A job's status can be queried until its report data is deleted. You can
initiate deletion of the data by calling `deleteStatusReport`,
and in any case the data will automatically be deleted upon the
expiration of the configurable time frame (by default 30 days).

## Path parameters

- `custNr` string, required
- `jobId` string, required

## Response `200`

Fax job status retrieved

- FaxReport
  - `jobId` string, required: The Job ID.
  - `recipientStatus` FaxRecipientWithStatus[], required
    - `number` string, required: The fax recipient's primary number (international format, e.g., +49891234678).
    - `properties` RecipientProperty[], nullable: Personalized data used for the cover page.
      - `key` string, required: Name of the key.
      - `value` string, required: The value assigned to the key.
    - `status` string, required: Job status, e.g., OK or ERROR.
    - `reason` string, required: Explanation of the status.
    - `sentTs` string, date-time: Timestamp which indicates when the fax was sent (in ISO 8601 format).
    - `durationInSecs` integer, required: Duration of the fax transmission until received by the fax recipient.
    - `sentToNumber` string: Number to which the fax was sent.
    - `remoteCsid` string: Fax ID which identifies the fax recipient.
  - `pages` integer, required: Number of pages in the fax.
  - `reference` Reference
    - `customerDefinedId` string: Freely-defined ID string (max. 256 characters).
    - `billingCode` string: Information on the cost center; format is arbitrary (max. 80 characters).
    - `billingInfo` string: Additional data for internal customer accounting (max. 80 characters).

## Other responses

- `401`: Authentication failed
- `404`: Status report not available

---

[API](https://skmtc.dev/retarus/apis/faxolution-for-applications-fax4a-rest-api.md) - [All operations](https://skmtc.dev/retarus/apis/faxolution-for-applications-fax4a-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/retarus/apis/faxolution-for-applications-fax4a-rest-api/revisions/64e666009b31?raw)