# Reports

## Get Account Report

> Retrieve a reportUrl by accountId, month, year, and report type. The reportUrl can be appended to the /files endpoint to access the report.

```json
{"openapi":"3.0.3","info":{"title":"Aquanow CAMS REST API","version":"1.0"},"servers":[{"url":"https://cams.aquanow.com/api","description":"production"},{"url":"http://localhost:3001/api","description":"local"},{"url":"https://camsapi-dev.aquanow.com/api","description":"dev"},{"url":"https://camsapi-staging.aquanow.com/api","description":"staging"},{"url":"https://cams.cert.aquanow.com/api","description":"cert"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer"}},"schemas":{"AccountStatementReport":{"type":"object","required":["accountId","month","year","reportType","reportUrl"],"properties":{"accountId":{"type":"string","format":"uuid","description":"The account ID"},"month":{"type":"integer","minimum":1,"maximum":12,"description":"The month of the report"},"year":{"type":"integer","minimum":2020,"maximum":2099,"description":"The year of the report"},"reportType":{"type":"string","enum":["MONTHLY_STATEMENT","MONTHLY_TAX_NOTICE"],"description":"The type of statement report"},"reportUrl":{"type":"string","format":"uri","description":"Signed S3 URL for the report (valid for 5 minutes)"}}}},"responses":{"400":{"description":"Validation Error"},"401":{"description":"Unauthorized"},"403":{"description":"Insufficient Privileges"},"404":{"description":"Not Found","content":{"application/json":{"schema":{"properties":{"id":{"type":"string"}}}}}},"4XX":{"description":"Client error"},"5XX":{"description":"Server error"}}},"paths":{"/v1/accounts/{accountId}/reports":{"get":{"operationId":"GetAccountReport","tags":["Accounts"],"summary":"Get Account Report","description":"Retrieve a reportUrl by accountId, month, year, and report type. The reportUrl can be appended to the /files endpoint to access the report.","parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"The account ID"},{"name":"reportType","in":"query","required":true,"schema":{"type":"string","enum":["MONTHLY_STATEMENT","MONTHLY_TAX_NOTICE"]},"description":"The type of report"},{"name":"year","in":"query","required":true,"schema":{"type":"integer","minimum":2020,"maximum":2099},"description":"The year of the report"},{"name":"month","in":"query","required":true,"schema":{"type":"integer","minimum":1,"maximum":12},"description":"The month of the report (1-12)"}],"responses":{"200":{"description":"Successful response with signed report URL","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountStatementReport"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"4XX":{"$ref":"#/components/responses/4XX"},"5XX":{"$ref":"#/components/responses/5XX"}}}}}}
```