rename directory

docs/endpoints/FINANCIAL_REPORTS_API_URL_meta.md

@@ -0,0 +1,19 @@
+# FINANCIAL_REPORTS_API_URL
+
+- **URL:** https://api.sgx.com/financialreports/v1.0
+- **Status:** 200
+- **Classification:** ACCESSIBLE
+- **Content-Type:** application/json
+- **Content-Length:** 
+- **Elapsed:** 
+- **Probed at:**
+## Notes
+
+`FINANCIAL_REPORTS_API_URL` was exempt from the initial discovery probe and must be called paginated. Manual probing on 2026-06-25 confirmed it works with `Origin`/`Referer` headers.
+
+- **Filter values:** `/metalist` returns a `companyName` list for UI filtering.
+- **List pattern:** `https://api.sgx.com/financialreports/v1.0?pagestart={n}&pagesize=2000&params=id,companyName,documentDate,securityName,title,url`
+  - `pagestart` begins at 1 (not 0). At `pagesize=2000` the corpus is ~7 pages (13,348 records observed).
+- **Response fields:** `id`, `companyName`, `documentDate` (ms since epoch), `securityName`, `title`, `url`.
+- **Document retrieval:** each `url` is a `https://links.sgx.com/1.0.0/corporate-announcements/{id}/{hash}` HTML detail page that hosts the actual PDF attachment(s). The API returns metadata only.
+- **Captured payloads:** `adv-investigation/payloads/resp_1300_financialreports_page1.json`, `resp_1301_financialreports_page2.json`, `resp_1302_financialreports_metalist.json`.