---
title: "List Reports"
method: GET
path: "/api/MobileApp/master/reports"
tags: ["MobileApp"]
---

# List Reports

`GET /api/MobileApp/master/reports`

## Request

- Base URL: `https://api.leapsurgebi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.leapsurgebi.com/api/MobileApp/master/reports`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/token`
- TypeScript: <https://skmtc.dev/leapsurgebi/apis/leapsurgeapi/docs/api/MobileApp/master/reports/get.ts> (a function with typed inputs; its response is checked against the schema)

**Function**: `list_reports`
**Type**: API Endpoint (GET)

**Purpose**:  
Retrieves a list of reports from the database with various details.

**Headers**:  
- `Customer_Key` (str, required): The customer key.
- `App_Code` (str, optional): The application code. If not provided, it defaults to 'AspireBI'.
- `Code` (str, optional): The user code.

**Response**:  
A JSON response containing a list of report objects, each with the following properties:
- `report_id`: The ID of the report.
- `report_name`: The name of the report.
- `display_name`: The display name of the report.
- `module`: The module code of the report.
- `application_type`: The application type of the report.
- `report_type`: The report type of the report.
- `report_path`: The report path of the report.
- `workspace_id`: The workspace ID of the report.
- `is_oem`: A boolean indicating if the report is OEM.
- `status`: A boolean indicating if the report is active.
- `shared_dataset`: A boolean indicating if the report uses a shared dataset.
- `modified_by`: The user who last modified the report.
- `modified_on`: The date and time when the report was last modified.
- `is_adminstrator`: A boolean indicating if the user is an administrator.
- `has_report_access`: A boolean indicating if the user has access to the report.

**Exceptions**:  
- Raises `JSONResponse` with a 404 status code if no reports are found.
- Raises `JSONResponse` with a 500 status code for any internal server errors.

## Headers

- `Customer-Key` string, required
- `App-Code` string, nullable
- `Code` string, nullable
- `Report-Type` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-24** `23b42df3193a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi/changes/api/MobileApp/master/reports/get.md)

---

[API](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi.md) - [All operations](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/leapsurgebi/apis/leapsurgeapi/revisions/13653cb8ee76?raw)