---
title: "Fetch available status reports for this account"
method: GET
path: "/{custNr}/fax/reports"
tags: ["Fax reports"]
---

# Fetch available status reports for this account

`GET /{custNr}/fax/reports`

## Request

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

This URL returns a list of available status reports for completed fax
jobs for the current account.

Status reports are available for up to 30 days or until deleted.

IMPORTANT: The results are limited to the oldest 1000 entries. It is recommended to
delete the status reports after fetching them in order to retrieve the
following ones.

**Please note**: This endpoint should only be used with a data center specific URL. This endpoint would return "inconsistent" results depending on the data center the request is processed by.

## Path parameters

- `custNr` string, required

## Response `200`

Status reports delivered

- FaxReports
  - `reports` FaxReport[], required
    - `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).

---

[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)