Reports
Aggregate reporting across properties and bookings.
2 endpoints. Every request needs an Authorization: Bearer mtro_... header, and responses follow the envelope described in Errors and conventions.
GET /reports/property-summary
Get a financial summary report for properties, including revenue, occupancy rates, and per-property breakdowns. Defaults to current month if no dates provided.
Required scope: reports.read
MCP tool: reports_property_summary
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
startTimestamp | number | no | Start of reporting period (timestamp ms). Defaults to start of current month. |
endTimestamp | number | no | End of reporting period (timestamp ms). Defaults to end of current month. |
entityId | string | no | Entity ID to report on (admin only, defaults to your entity) |
Example
curl -X GET 'https://core.mtro.app/reports/property-summary?startTimestamp=<startTimestamp>&endTimestamp=<endTimestamp>&entityId=<entityId>' \
-H 'Authorization: Bearer mtro_your_api_key'
Response
| Field | Type |
|---|---|
entity | object |
properties | object[] |
totalRevenue | integer |
averageOccupancy | integer |
period | object |
Fields of entity
| Field | Type |
|---|---|
id | string |
name | string |
GET /reports/trends
Get trend data and analytics for properties over time.
Required scope: reports.read
MCP tool: reports_trends
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
startTimestamp | number | no | Start of trend period (timestamp ms) |
endTimestamp | number | no | End of trend period (timestamp ms) |
entityId | string | no | Entity ID (admin only) |
Example
curl -X GET 'https://core.mtro.app/reports/trends?startTimestamp=<startTimestamp>&endTimestamp=<endTimestamp>&entityId=<entityId>' \
-H 'Authorization: Bearer mtro_your_api_key'
Response
| Field | Type |
|---|---|
trends | object[] |
Fields of trends[]
| Field | Type |
|---|---|
month | string |
revenue | integer |
occupancy | integer |
period | object |