v1

latestOpenAPI 3.1.02026-07-2483219318.4 KB
Reports

Get report details

get/v1/applications/{applicationId}/reports/{reportId}

Path parameters

applicationIdstring required
Example:application_tz4a98xxat96iws9zmbrgj3a
reportIdstring required
Example:report_tz4a98xxat96iws9zmbrgj3a

Response

Success

_idstring required
status'processing' | 'completed' | 'failed' required

The status of a report:

  • processing This report is currently being synthesized.

  • completed This report has successfully been synthesized and data can now be retrieved from it.

  • failed This report has failed to be synthesized. See failure_reason for more information.

generated_atstring date-time

The date that this report completed synthesis.

expires_atstring date-time required

The date that this report expires. After this date the report will no longer be accessible.

insightsInsightCategoryCode[]

When this report is completed, this field will hold a list of all insights used in this report.

Example response

{
  "_id": "report_tz4a98xxat96iws9zmbrgj3a",
  "resources": [
    {
      "_id": "doc_tz4a98xxat96iws9zmbrgj3a"
    }
  ],
  "spending_categories": [
    {
      "code": "spending:000/useful-name-here"
    }
  ],
  "income_categories": [
    {
      "code": "income:000/useful-name-here"
    }
  ],
  "insights": [
    "insight:000/useful-name-here"
  ]
}