Skip to main content
POST
/
v1
/
reports
Create report
curl --request POST \
  --url https://api-sandbox.y.uno/v1/reports \
  --header 'Content-Type: application/json' \
  --header 'account-code: <api-key>' \
  --header 'private-secret-key: <api-key>' \
  --header 'public-api-key: <api-key>' \
  --data '
{
  "date_range": {
    "from": "2026-02-01T00:00:00.000Z",
    "to": "2026-02-28T23:59:59.999Z"
  },
  "type": "TRANSACTIONS"
}
'
{
  "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "status": "PROCESSING",
  "date_range": {
    "from": "2026-02-01T00:00:00.000Z",
    "to": "2026-02-28T23:59:59.999Z"
  },
  "download_url": null,
  "created_at": "2026-03-01T12:00:00.000Z"
}
This endpoint allows you to request the generation of specific report types. The response from this endpoint provides an object containing:
  • The status of the report generation.
  • A report id.
Use the report id to download the report using the Download a Report endpoint after it is generated.

Authorizations

​
public-api-key
string
header
required

Your public API key from the Yuno Dashboard

​
private-secret-key
string
header
required

Your private secret key (server-side only)

​
account-code
string
header
required

Your account identifier. The alias X-Account-Code is also accepted.

Body

application/json
​
date_range
object
required

Date range for the report. Must use datetime format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z'), not date-only format.

​
type
string

Type of report to generate

Example:

"TRANSACTIONS"

Response

Report generation initiated

​
id
string<uuid>
Example:

"a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

​
status
enum<string>

Report generation status

Available options:
PROCESSING,
COMPLETED,
FAILED
Example:

"PROCESSING"

​
date_range
object
​
download_url
string<uri>

URL to download the completed report

Example:

"https://reports.y.uno/download/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"

​
created_at
string<date-time>
Example:

"2026-03-01T12:00:00.000Z"