> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/reports/asset-reports.md).

# Asset reports

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: web. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/reports/asset-reports.md).
{% endhint %}

Create the "Multi-Asset Report (export)" spreadsheet from the assets in the chosen asset registers, and download it from the list of created reports. The page works like [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md); this page describes only what differs.

![Asset reports](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-e2a9f3ffce7f64a8332c99503b981d4267d70676%2Fasset-reports.png?alt=media)

* **Where:** web `/dashboard-reports/asset-reports`, the "Asset Reports" tab of "Dashboard & Reports"
* **Who:** any signed-in user can open the page. Creating a report needs `perJobReportGenerate` in every asset register the filters select, checked in the browser as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#actions).
* **Feature:** [Asset reports](https://docs.snapfix.com/product/features/reports/asset-reports.md)

## Layout

The same as [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#layout): the report type and "Create" on the left, "Your reports" on the right. The page has one card, "Multi-Asset Report (export)", with the line "Spreadsheet report of multiple assets.". In the list, a multi-asset report is named "Multi-Asset Report".

## Inputs

| Field                                   | Type                                                                                                                             | Required | Default                                                                                                                                                 | Rules and messages                                                                                                            |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Report type                             | The one card                                                                                                                     | Yes      | None                                                                                                                                                    | It must be picked before "Create" is on.                                                                                      |
| Asset registers ("… asset register(s)") | Several registers                                                                                                                | No       | The user's own registers of the site, from [`GET /v1/app/asset-regs`](https://docs.snapfix.com/engineering-reference/api/assets.md#get-v1appasset-regs) | Sent as `business_uuids`. An empty selection is applied as all of them again. With no register loaded, "Create" is not drawn. |
| Other filters                           | As on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#inputs), without groups and tags | No       | "Active assets", all three statuses, created in the last month                                                                                          | The labels say assets: "Active assets", "Archived assets", "Only includes assets with cost".                                  |
| "Attribute"                             | Text                                                                                                                             | No       | Empty                                                                                                                                                   | Offered for asset registers only. The page never sends it, so it does not change the report.                                  |

## Actions

| Action           | Who                                                                                                      | What happens                                                                                                                                                                                      | API                                                                                                                             |
| ---------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Create           | Any signed-in user with `perJobReportGenerate` in every selected register                                | Queues the report and adds it to "Your reports", as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#actions).                                        | [`multi_asset_report_excel`](https://docs.snapfix.com/engineering-reference/api/reports.md#post-actionmulti_asset_report_excel) |
| Load the list    | Any signed-in user                                                                                       | The user's multi-asset and single-asset reports from the last 30 days, loaded and polled as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#states). | [`user_asset_reports`](https://docs.snapfix.com/engineering-reference/api/reports.md#post-actionuser_asset_reports)             |
| Download, delete | As on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#actions) | As on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#actions).                                                                                         | [`delete_user_report`](https://docs.snapfix.com/engineering-reference/api/reports.md#post-actiondelete_user_report) for delete  |

When the page opens, it asks the survey tool to show the survey for `WebReportsAssetsScreen`, with the same details as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#actions) \[[ASK-116](https://github.com/snapfix/docs/blob/main/ASK.md#ask-116-may-the-survey-tool-receive-users-contact-details-and-site-names)].

## States

As on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#states). With no asset report in the last 30 days the list says "No data available", with "0 of 0".

## Dialogs and sheets

* **Permission alert:** the same message as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#dialogs-and-sheets). It says "The group …" and asks the user to uncheck it "from the Groups filter", but here the item is an asset register and the filter is not called Groups.
* **Delete report:** as on [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md#dialogs-and-sheets).
* **Filters:** the shared filter drawer ([Filters](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#filters)), with the "Attribute" panel added.

## Platform differences

Web only for the multi-asset spreadsheet. The apps' asset lists offer task reports for the register's tasks instead ([Asset list](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-list.md)). On Android, the asset list's "+" menu also has "Asset Details Report (XLSX)": it writes a CSV file of the register's tasks that the phone has loaded, with the assets' attributes, and shares it. It makes no request and no report row, and the file is a CSV of tasks, not an XLSX of assets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/reports/asset-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
