> For the complete documentation index, see [llms.txt](https://integrations.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.impact.com/partner-api-reference/reference/reports/reports.md).
# Reports
List available reports, fetch their metadata, and run them synchronously.
## List all available reports
> Retrieves a list of all available reports. Only reports with \`ApiAccessible: true\` can be run programmatically — the rest are UI-only and return a \`RunUri\` pointing to the impact.com web app.
```json
{"openapi":"3.1.0","info":{"title":"Partner Reports API","version":"16"},"tags":[{"name":"Reports","description":"List available reports, fetch their metadata, and run them synchronously."}],"servers":[{"url":"https://api.impact.com","description":"Production server"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"Report":{"type":"object","properties":{"Name":{"type":"string","description":"Display name of the report."},"Id":{"type":"string","description":"The report handle used in the path of all other Report endpoints."},"Category":{"type":"string","enum":["Admin","Beta","Compliance","Cross-Program","Custom","Finance","Insights","Listing","Operations","Performance"],"description":"Category that groups related reports in the impact.com UI. May be empty for some reports."},"Description":{"type":"string","description":"A short description of what the report contains."},"ApiAccessible":{"type":"boolean","description":"When `true`, this report can be run via the API at `ApiRunUri` and exported via `DeferredApiRunUri`. When `false`, the report is UI-only and `RunUri` contains the impact.com web app link."},"ApiRunUri":{"type":"string","description":"API resource path to run this report synchronously. Present only when `ApiAccessible` is `true`."},"DeferredApiRunUri":{"type":"string","description":"API resource path to export this report asynchronously. Present only when `ApiAccessible` is `true`."},"MetaDataUri":{"type":"string","description":"API resource path to retrieve this report's metadata. Present only when `ApiAccessible` is `true`."},"RunUri":{"type":"string","description":"Link to view the report in the impact.com web app. Present only when `ApiAccessible` is `false`."}}}}},"paths":{"/Mediapartners/{AccountSID}/Reports":{"get":{"operationId":"listReports","tags":["Reports"],"summary":"List all available reports","description":"Retrieves a list of all available reports. Only reports with `ApiAccessible: true` can be run programmatically — the rest are UI-only and return a `RunUri` pointing to the impact.com web app.","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."}],"responses":{"200":{"description":"A list of report objects.","content":{"application/json":{"schema":{"type":"object","properties":{"Reports":{"type":"array","items":{"$ref":"#/components/schemas/Report"}}}}}}}}}}}}
```
## Run a report (Legacy)
> Runs a report synchronously and returns the records inline. Page size is fixed at 20,000 rows — for larger datasets use the Report Export endpoint instead.\
> \
> Call \`/Reports/{Id}/MetaData\` first to learn which filters the report accepts and which columns it returns. The \`Records\` array contains one object per row with column names matching the metadata \`Attributes\`.\
> \
> \*\*Note:\*\* Starting September 1, 2025, this endpoint enforces stricter page limits. For production workloads against datasets that may exceed 20,000 rows, use Report Export.
```json
{"openapi":"3.1.0","info":{"title":"Partner Reports API","version":"16"},"tags":[{"name":"Reports","description":"List available reports, fetch their metadata, and run them synchronously."}],"servers":[{"url":"https://api.impact.com","description":"Production server"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}}},"paths":{"/Mediapartners/{AccountSID}/Reports/{Id}":{"get":{"operationId":"runReport","tags":["Reports"],"summary":"Run a report (Legacy)","description":"Runs a report synchronously and returns the records inline. Page size is fixed at 20,000 rows — for larger datasets use the Report Export endpoint instead.\n\nCall `/Reports/{Id}/MetaData` first to learn which filters the report accepts and which columns it returns. The `Records` array contains one object per row with column names matching the metadata `Attributes`.\n\n**Note:** Starting September 1, 2025, this endpoint enforces stricter page limits. For production workloads against datasets that may exceed 20,000 rows, use Report Export.\n","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."},{"name":"Id","in":"path","required":true,"description":"The report handle (e.g., `mp_action_listing_fast`). Get this from the `Id` field returned by List Reports.","schema":{"type":"string"}},{"name":"SUBAID","in":"query","required":false,"description":"Program ID to scope the report to a single brand. Omit to include all programs you partner with.","schema":{"type":"string"}},{"name":"START_DATE","in":"query","required":true,"description":"Start date for the report's date range, in `YYYY-MM-DD` format.","schema":{"type":"string","format":"date"}},{"name":"END_DATE","in":"query","required":true,"description":"End date for the report's date range, in `YYYY-MM-DD` format.","schema":{"type":"string","format":"date"}},{"name":"RQueryIDx","in":"query","required":false,"description":"For reports that return multiple result tables, selects which table to return.","schema":{"type":"integer","default":0}}],"responses":{"200":{"description":"Report results.","content":{"application/json":{"schema":{"type":"object","properties":{"Records":{"type":"array","description":"One object per row. Keys match the column names returned by the report's MetaData `Attributes`.","items":{"type":"object","additionalProperties":true}}}}}}},"404":{"description":"No report exists with the supplied Id, or the report is not API accessible."}}}}}}
```
## Retrieve report metadata
> Returns the dynamic documentation for a report — the filters it accepts and the attributes (columns) it returns. Call this before running a report to learn its exact contract.
```json
{"openapi":"3.1.0","info":{"title":"Partner Reports API","version":"16"},"tags":[{"name":"Reports","description":"List available reports, fetch their metadata, and run them synchronously."}],"servers":[{"url":"https://api.impact.com","description":"Production server"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"ReportMetadata":{"type":"object","properties":{"Name":{"type":"string","description":"Display name of the report."},"Id":{"type":"string","description":"The report handle."},"Description":{"type":"string","description":"A short description of what the report contains."},"Filters":{"type":"array","description":"The filters this report accepts as query parameters when run.","items":{"$ref":"#/components/schemas/ReportFilter"}},"Attributes":{"type":"array","description":"The columns this report returns. Each row in a Run Report response contains one key per attribute.","items":{"$ref":"#/components/schemas/ReportAttribute"}},"RunUri":{"type":"string","description":"API resource path to run this report."},"Uri":{"type":"string","description":"Unique reference to this report's metadata in the impact.com API."}}},"ReportFilter":{"type":"object","properties":{"Name":{"type":"string","description":"The filter's name. Use this as the query parameter when running the report."},"DataType":{"type":"string","enum":["Boolean","Date (yyyy-MM-dd'T'HH:mm:ssZZ)","Decimal","Integer","String"],"description":"Data type the filter accepts."},"Format":{"type":"string","description":"Additional format hint for the filter, if any."}}},"ReportAttribute":{"type":"object","properties":{"Name":{"type":"string","description":"The column name as it appears in each record returned by Run Report."},"DataType":{"type":"string","description":"Data type of values in this column."},"Description":{"type":"string","description":"A short description of what this column represents."}}}}},"paths":{"/Mediapartners/{AccountSID}/Reports/{Id}/MetaData":{"get":{"operationId":"retrieveMetadata","tags":["Reports"],"summary":"Retrieve report metadata","description":"Returns the dynamic documentation for a report — the filters it accepts and the attributes (columns) it returns. Call this before running a report to learn its exact contract.","parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Unique identifier for the partner account."},{"name":"Id","in":"path","required":true,"schema":{"type":"string"},"description":"The report handle (e.g., `mp_action_listing_fast`). Get this from the `Id` field returned by List Reports."}],"responses":{"200":{"description":"Report metadata details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportMetadata"}}}},"404":{"description":"No report exists with the supplied Id."}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://integrations.impact.com/partner-api-reference/reference/reports/reports.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.