# Fetch available status reports for this account

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.

Endpoint: GET /{custNr}/fax/reports
Version: v1
Security: httpBasicAuth

## Path parameters:

  - `custNr` (string, required)
    Customer Number

## Response 200 fields (application/json):

  - `reports` (array, required)

  - `reports.jobId` (string, required)
    The Job ID.

  - `reports.recipientStatus` (array, required)

  - `reports.recipientStatus.number` (string, required)
    The fax recipient's primary number (international format, e.g., +49891234678).

  - `reports.recipientStatus.properties` (array)
    Personalized data used for the cover page.

  - `reports.recipientStatus.properties.key` (string, required)
    Name of the key.
    Example: key123

  - `reports.recipientStatus.properties.value` (string, required)
    The value assigned to the key.
    Example: value123

  - `reports.recipientStatus.status` (string, required)
    Job status, e.g., OK or ERROR.

  - `reports.recipientStatus.reason` (string, required)
    Explanation of the status.

  - `reports.recipientStatus.sentTs` (string)
    Timestamp which indicates when the fax was sent (in ISO 8601 format).

  - `reports.recipientStatus.durationInSecs` (integer, required)
    Duration of the fax transmission until received by the fax recipient.

  - `reports.recipientStatus.sentToNumber` (string)
    Number to which the fax was sent.

  - `reports.recipientStatus.remoteCsid` (string)
    Fax ID which identifies the fax recipient.

  - `reports.pages` (integer, required)
    Number of pages in the fax.

  - `reports.reference` (object)

  - `reports.reference.customerDefinedId` (string)
    Freely-defined ID string (max. 256 characters).
    Example: 2022-04-7T11:04:37.057Z_customerDefinedId

  - `reports.reference.billingCode` (string)
    Information on the cost center; format is arbitrary (max. 80 characters).
    Example: 2022-04-7T11:04:37.057Z_billingCode

  - `reports.reference.billingInfo` (string)
    Additional data for internal customer accounting (max. 80 characters).
    Example: 2022-04-7T11:04:37.057Z_billingInfo