# IESO Reports Site REST API

**Canonical:** https://apis.io/apis/ieso/ieso-reports-site-rest-api/  
**Provider:** IESO — https://apis.io/providers/ieso/  
**Base URL:** https://reports.ieso.ca/api/v1.4  
**Documentation:** https://www.ieso.ca/sector-participants/technical-interfaces

IESO Reports Site REST API is one of 9 APIs that [IESO](https://apis.io/providers/ieso/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Reports, File Transfer, Market Participants, and REST. The published artifact set on APIs.io includes API documentation.

A RESTful file-access API provided by Axway SecureTransport, used to automate retrieval of reports from the IESO Reports Site. Accepts and returns both JSON and XML, and exposes file and directory listing (GET /files, GET /files/{path}), file property inspection (?status) and file download, with limit, sortBy and order parameters. Every request must carry the query string parameter ?idp_id=ieso and HTTP Basic credentials. IESO documents this endpoint only for the CONFIDENTIAL participant report repository — the guide states plainly that "the recommended programmatic access applies to confidential reports repository and not public reports". Credentials are IESO-issued machine accounts granted to registered Ontario market participants on request; there is no self-serve signup. Probed anonymously on 2026-07-27: https://reports.ieso.ca/api/v1.4/files?idp_id=ieso returned HTTP 401, and the sandbox at reports-sandbox.ieso.ca returned HTTP 401. The same path on the public host (reports-public.ieso.ca) returned HTTP 404 — the open data is not served through this API.

## Machine-readable artifacts (3)

- **Documentation** — https://www.ieso.ca/-/media/Files/IESO/technical-interfaces/api-reports-guide/IESO_Reports_API_Guide.pdf
- **Specification** — https://www.ieso.ca/-/media/Files/IESO/technical-interfaces/xml-automated-docs/IMO_SPEC_0100.pdf
- **Documentation** — https://www.ieso.ca/sector-participants/technical-interfaces

## Other IESO APIs (8)

- [IESO Public Reports Repository](https://apis.io/apis/ieso/ieso-public-reports-repository/)
- [IESO Market Information Management (MIM) Web Services](https://apis.io/apis/ieso/ieso-mim-web-services/)
- [IESO Registration System Facilities API](https://apis.io/apis/ieso/ieso-registration-facilities-api/)
- [IESO Retrofit System API](https://apis.io/apis/ieso/ieso-retrofit-api/)
- [IESO Retrofit Service Provider API](https://apis.io/apis/ieso/ieso-retrofit-service-provider-api/)
- [IESO Dispatch Service Web Service](https://apis.io/apis/ieso/ieso-dispatch-service-web-service/)
- [IESO Dispatch Notification Service Web Service](https://apis.io/apis/ieso/ieso-dispatch-notification-service/)
- [IESO Outage Coordination and Scheduling System (OCSS) Web Service](https://apis.io/apis/ieso/ieso-ocss-web-service/)

## Tags

Reports, File Transfer, Market Participants, REST

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ieso/ieso-reports-site-rest-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ieso/.