This request returns the reports that are created after you schedule them using the Schedule Report request.

To list the reports, use a GET method and the following URL:

https://reporting-api.marketplace.taxamo.com/api/v3/reports?limit={limit}=1&status={status}&report_type={report type}&created_after={created_after_date}'

For example:

curl --request GET \
     --url 'https://reporting-api.marketplace.taxamo.com/api/v3/reports?limit=5&offset=1&status=Done&report_type=Audit&created_after=2024-01-01' \
     --header 'accept: application/json'

Details

Detail	Value
Endpoint	`/api/v3/reports`
Method	GET

Query Parameters

Field	Type	Format	Description
`limit`	Integer	n/a	The number of reports included in a single response. The default is 10.
`offset`	Integer	n/a	A number of reports to skip, used for pagination. The default is 0
`status`	String	n/a	The report's status. It can be one of `Queued`, `Done`, `Failed` or `Processing`.
`report_type`	String	n/a	The type of report. It can be either `Audit` or `Tax-ID`.
`created_after`	String	`yyyy-MM-dd`	The request will list all reports created on and after this date.
`created_before`	String	`yyyy-MM-dd`	The request will list all reports created on and before this date.

Output Parameters

The following parameters are returned for each report:

Field	Type	Format	Description
`presigned-url`	String	n/a	The pre-signed URL for the report, if available.
`started-timestamp`	String	n/a	The time that the report started at.
`report-type`	String	n/a	The type of report. It can be `Audit` or `Tax-ID`.
`filename`	String	n/a	The name of the report file.
`status`	String	n/a	The report's status. It can be one of `Queued`, `Done`, `Failed` or `Processing`.
`created-timestamp`	String	`$date-time`	The time that the report is created that is when processing is done.
`error-message`	String	n/a	If the report failed, the error message is included.
`uuid`	String	`$uuid`	The UUID of the report query.
`parameters`	String	n/a	See Schedule Reports Input Parameters
`finished-timestamp`	String and Null	n/a	The time that report processing finished.

Example

Request

curl --request GET \
     --url 'https://reporting-api.marketplace.taxamo.com/api/v3/reports?limit=5&offset=1&status=Done&report_type=Audit&created_after=2024-01-01' \
     --header 'accept: application/json'

Response

The following information is returned with a 200 success response:

{
  "reports": [
    {
      "presigned-url": "string",
      "started-timestamp": "2024-11-05T13:34:58.581Z",
      "report-type": "Audit",
      "filename": "string",
      "status": "Queued",
      "created-timestamp": "2024-11-05T13:34:58.581Z",
      "error-message": "string",
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "parameters": {
        "format": "csv",
        "product-classes": "PSSPPDPDPDSPDDDDPDSSPSPSDDDPPPDPPDPDDDDDDPPPDSPPDDSDDPDPPDDSDPDSSSPPPPSSPSSSSPDDPSPDDPD",
        "fx-source": "string",
        "tax-country-subdivision-code": "yg-x_",
        "end-month": "7574-69",
        "tax-country-code": "st",
        "currency-code": "daH",
        "fx-date-type": "day",
        "tax-region-key": "PR",
        "start-month": "3200-88",
        "report-scope": "full",
        "transaction-type": "sale",
        "fx-date-field": "tax-timestamp"
      },
      "finished-timestamp": "2024-11-05T13:34:58.582Z"
    },
    {
      "presigned-url": "string",
      "started-timestamp": "2024-11-05T13:34:58.582Z",
      "report-type": "Tax-ID",
      "filename": "string",
      "status": "Queued",
      "created-timestamp": "2024-11-05T13:34:58.582Z",
      "error-message": "string",
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "parameters": {
        "tax-ids": [
          "string"
        ],
        "region-keys": [
          "LF",
          "unknown"
        ],
        "validation-statuses": [
          "syntax-valid-full-valid-cache-not-used"
        ],
        "result-changed": true,
        "start-month": "0424-68",
        "end-month": "2044-56"
      },
      "finished-timestamp": "2024-11-05T13:34:58.582Z"
    }
  ]
}