Reports

View a Report

Changed on

Retrieve a legacy report

get/v2.01/{ClientId}/reports/{ReportId}

Request

  • Base URL
    https://api.sandbox.mangopay.com
  • URL
    https://api.sandbox.mangopay.com/v2.01/{ClientId}/reports/{ReportId}
  • Auth
    HTTP bearer

Path parameters

ClientIdstring required

Platform's API account identifier, associated with the API key.

ReportIdstring required

The unique identifier of the legacy report.

Response

Success

Idstring

Max length: 128 characters (see data formats for details)

The unique identifier of the object.

CreationDateinteger

Unix timestamp (UTC) of the date and time the object was created.

Tagstring

Max. length: 255 characters

Custom data that you can add to this object, such as unique identifiers in your system. To store multiple values, you can serialize them into a single string, for example a JSON object: "{\"id_1\":AB123,\"id_2\":DE456}".

ReportDateinteger nullable

Unix timestamp (UTC) of the date and time the report was generated.

Statusstring

Returned values: PENDING, READY_FOR_DOWNLOAD, FAILED, EXPIRED

The status of the report:

  • PENDING – The report is being generated.
  • READY_FOR_DOWNLOAD – The report has been created, and can be downloaded.
  • FAILED – The report cannot be generated.
  • EXPIRED – The report was created, but is no longer available for download (it can be re-run to be downloaded again with fresh data).
DownloadFormatstring

Returned values: CSV

The format in which the report is going to be downloaded.

DownloadURLstring nullable

The URL at which the report file can be downloaded when the Status is GENERATED.

CallbackURLstring

Max. length: 255 characters

The URL to which the notification indicating that the report is ready to be downloaded will be sent.

ReportTypestring

Returned values: TRANSACTIONS, WALLETS

The type of the report, indicating whether it lists transactions or wallets.

Sortstring

The sorting direction of the CreationDate column. By default, the generated report is sorted by ascending creation date.

Previewboolean

Whether the report is limited to the first 10 lines (and therefore quicker to generate).

Columnsstring[]

Returned values: The Columns listed in the <a href="/reports">Reports</a> article, which differ according to the report type.

The information to be included in the report.

ResultCodestring[]

The transaction result codes to be taken into account.

ResultMessagestring

The explanation of the result code.

Changes

  • f44a59c76515Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security oauth2 was added to the API

  • 8e731ec4a85bRevision changes
    • info

      api operation id view_report_legacy removed and replaced with reports_view_report_legacy