List recent report files

Revenue API

Request

Returns up to number_of_records Available report files, sorted by creation time with the newest first.

Purpose: Pick up recently produced files without tracking dates or submission IDs.

When to use: When you want the latest completed files without tracking dates or submission IDs, for example in a frequent polling job.

Notes:

Keep number_of_records small (for example 10 to 50) to keep responses fast.

Request definition

Parameter	In	Type	Required	Description
`number_of_records`	path	integer	Yes	Maximum number of files to return.
`Zuora-Track-Id`	header	string	No	Optional correlation identifier (up to 64 characters) that you choose. The Zuora One gateway records it; quote it to Zuora Support when you report a problem.
`Authorization`	header	string	Yes	`Bearer <access_token>` (Zuora OneID OAuth).

Request body: none.

Response definition

HTTP status	Content type	Response schema
`200`	`application/json`	ReportFileListResponse
`400`	`application/json`	RiaError
`401`	`application/json`	GatewayError or RiaError
`403`	`application/json`	RiaError
`404`	`application/json`	RiaError
`429`	`application/json`	GatewayError
`500`	`application/json`	RiaError
`502`	`application/json`	RiaError

ReportFileListResponse: Success envelope for the report-file operations.

Field	Type	Required	Description
`Status`	string	No	`Success` when the call completed.
`Message`	string	No	Additional message. Empty on success.
`Result`	array of ReportFile	No	Matching Available report files. An empty array means nothing matched.
`Result[].id`	integer	No	Submission identifier of the run that produced the file. Use it with `GET /reports/{report_id}` and the v2 signed-URL operation.
`Result[].file_name`	string	No	Name of the generated file. Use it with `GET /reports/download/{filename}`.
`Result[].rep_name`	string	No	Name of the report definition that produced the file.
`Result[].category`	string	No	Report category.
`Result[].rep_desc`	string	No	Report description.
`Result[].layout_name`	string	No	Name of the layout that was run.
`Result[].report_date`	string	No	Date and time the run was created, formatted `DD-MM-YYYY HH24:MI:SS`.
`Result[].status`	string	No	Run status. These operations only return Available runs, so the value is `A` (or `Available` on some tenant database platforms). Allowed: `A`, `Available`.
`Result[].org_id`	string	No	Organization security value of the run. Returned on some tenant database platforms only.

Error response schemas (GatewayError, ServiceError, SpringError, SimpleError, MissingFiltersError, RunStatusConflict, RiaError, SignedUrlError) are defined once under Error response schemas in the API overview and in components/schemas.

Response codes: 200, 400, 401, 403, 404, 429, 500, 502. Each response with a body includes worked examples; responses without a body say so.

Security

OneIdOAuth

Path

number_of_recordsintegerrequired

Maximum number of files to return.

Example:10

Zuora-Track-Idstring

Optional correlation identifier (up to 64 characters) that you choose. The Zuora One gateway records it; quote it to Zuora Support when you report a problem.

Example:close-run-2026-09-001

cURL

curl -i -X GET \
  https://one.zuora.com/api/integration/v1/reports/recent-n/10 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Zuora-Track-Id: close-run-2026-09-001'

Responses

Success. Recent report files.

Bodyapplication/json

Statusstring

Success when the call completed.

Example:"Success"

Messagestring

Additional message. Empty on success.

Example:""

ResultArray of objects(ReportFile)

Matching Available report files. An empty array means nothing matched.

Response

{
  "Status": "Success",
  "Message": "",
  "Result": [
    { … },
    { … }
  ]
}