Skip to content

Perform bulk operations on the status reports

Request

It is possible to perform bulk operations on the status reports through a POST on the /{custNr}/fax/reports endpoint. The required parameters are:

  • the type of action to be performed
  • A list of Job IDs on which the operation should be performed

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

The maximum number of jobs per POST request is set to 1000.

Please note: This endpoint should only be used with a data center specific URL. This endpoint could return an error about unknown job IDs depending on the data center the request is processed by.

Security
httpBasicAuth
Path
custNrstringrequired

Customer Number

Bodyapplication/jsonrequired

Array of jobIds to delete from the API.

actionstringrequired

Defines the action to be performed on all jobs whose Job ID is provided in the jobIds list

Possible options are:

  • DELETE: Bulk delete the requested jobs
  • GET: Bulk get the requested jobs

Both options are case insensitive.

jobIdsArray of stringsrequired

List of Job IDs to be processed in bulk

curl -i -X POST \
  -u '<username>:<password>' \
  'https://developers.retarus.com/_mock/fax/fax4a-api/{custNr}/fax/reports' \
  -H 'Content-Type: application/json' \
  -d '{
    "action": "GET",
    "jobIds": [
      "FJJ5Y09UM505ZZBIELCRYC",
      "FJJ5WA23UO05ZZBIEL0JY5",
      "FJJ5WA0FWM05ZZBIELZPE4",
      "FJJ5Y07H3805ZZBIELBAPL",
      "FJJ5WA25VB0BRN8TPSGGVY",
      "FJJ5WA253505ZZBIELEKRC",
      "FJJ5WA24GI0BRN8TPSWAVM"
    ]
  }'

Responses

Depending on the request type, this returns a reports item containing either:

  • an array of Fax Report items for the bulk GET (same as getAllStatusReports).
  • an array of Job Delete Report items for the bulk DELETE.
Bodyapplication/json
reportsArray of objects(Bulk Job Reports Response)
Response
{
  "reports": [
    { … },
    { … },
    { … },
    { … },
    { … },
    { … },
    { … }
  ]
}