---
title: "api_reports_metadata_list_get"
method: GET
path: "/accounts/{aid}/reports/metadata"
tags: ["reports"]
---

# api_reports_metadata_list_get

`GET /accounts/{aid}/reports/metadata`

Get list of report metadata for the account

Scopes:
  - read:reports
  - admin:reports

## Path parameters

- `aid` string, ^[PT]{1}\d{8}$, required

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

Report Metadata

- object
  - `reports` ReportMetadata[]
    - `id` string — Unique identification of the report
    - `report_job_id` string — Unique identification for all reports created by the same reportconfig at the same time (with different content types)
    - `account_id` string — Id of the report owner
    - `template_id` string — Id of the template used to create the report
    - `content_type` string — Report content type
    - `content_language` string — Report content language
    - `created_by` string — The ID of the user/client that created the report
    - `created_at` string, date-time — The date-time when the report was created
    - `data_from` string, date-time — The start of the data interval, contains created_at if data_from qparam not provided
    - `data_to` string, date-time — The end of the data interval, contains created_at if data_to qparam not provided
    - `schedule` string — Schedule for the report
    - `report_file_name` string — Name of the report file stored in S3.
    - `custom_report_name` string — Custom name of the report, defined in the report configuration used to generate the report
    - `report_config_id` string — Id of the report configuration used to generate the report.
    - `data_type` string — Source of the data used to generate the report. Defined by the report configuration used to create the report
    - `signed_url` string — Signed url used to download the report from s3
    - `report_filters` ReportFilter[] — List of filters used to filter the data for the report. Similar to SQL WHERE-clause. i.e, WHERE filter=value
      - `filter` 'operation_payout_destination' | 'store_id' — The "field/column" the data will be filtered on
      - `value` string — The value the records must contain for the provided filter (field/column)
  - `starting_after` string — cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.

## Other responses

- `400` — Bad / Invalid request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Unexpected Error

---

[API](https://skmtc.net/dintero/apis/account-management-api.md) · [All operations](https://skmtc.net/dintero/apis/account-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dintero/account-management-api/revisions/9b83a4199008/schema)