> ## Documentation index
> Fetch the complete documentation index at: https://docs.prescientai.com/llms.txt
> Use this file to discover all available pages before exploring further. Add `.md` to any page URL to get that page as Markdown.

# reportedMetrics

> Reference for the reportedMetrics query of the Prescient GraphQL API, with its arguments, its return type, and an example request.

```graphql
# Query
reportedMetrics(after: BigInt, campaignIds: [String!], endDate: ISO8601Date, processDate: ISO8601Date, startDate: ISO8601Date): ReportedMetricQuery!
```

Get reported spend metrics for campaigns by date. Returns spend data per campaign/day. Results will be paginated, so implementations should handle making multiple calls using the `after` argument.

## Arguments

Each argument is optional unless the list marks it as required.

| Argument      | Type          | Required | Description                                                                                                                                                                      |
| ------------- | ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `after`       | `BigInt`      | Optional | The cursor to indicate where the pagination should begin. Value comes from the `pageInfo>endCursor` field in the previous response.                                              |
| `campaignIds` | `[String!]`   | Optional | Filter by campaign ids. These correspond to the ids of your campaigns in their respective source channels.                                                                       |
| `endDate`     | `ISO8601Date` | Optional | End date for the reporting records. Defaults to today.                                                                                                                           |
| `processDate` | `ISO8601Date` | Optional | Filters out any records that have not been created or updated since this date. We recommend using this field in all implementations to avoid pulling large, unchanged data sets. |
| `startDate`   | `ISO8601Date` | Optional | Start date for the reporting records. Defaults to 30 days ago.                                                                                                                   |

## Returns

The query returns [`ReportedMetricQuery`](https://docs.prescientai.com/api/types#reportedmetricquery), written as `ReportedMetricQuery!` in the schema. The type has these fields.

| Field      | Type                    | Nullable | Description                                   |
| ---------- | ----------------------- | -------- | --------------------------------------------- |
| `data`     | `[ReportedMetricRow!]!` | No       | The array containing the reported metric rows |
| `pageInfo` | `PageInfo!`             | No       | Pagination info for the query                 |

## Example request

Send the query in the `query` field of the request body, and the variables in the `variables` field.

```graphql title="Query"
query reportedMetrics(
  $after: BigInt
  $campaignIds: [String!]
  $endDate: ISO8601Date
  $processDate: ISO8601Date
  $startDate: ISO8601Date
) {
  reportedMetrics(
    after: $after
    campaignIds: $campaignIds
    endDate: $endDate
    processDate: $processDate
    startDate: $startDate
  ) {
    data {
      campaignId
      campaignName
      channelName
      processDate
      reportedDate
      spend
    }
    pageInfo {
      endCursor
      hasNextPage
    }
  }
}
```

```json title="Variables"
{
  "after": null,
  "campaignIds": [
    "1234567890"
  ],
  "endDate": "2026-01-31",
  "processDate": "2026-01-15",
  "startDate": "2026-01-01"
}
```

## Example response

The values in this response are examples. They are not real data.

```json title="Response"
{
  "data": {
    "reportedMetrics": {
      "data": [
        {
          "campaignId": "1234567890",
          "campaignName": "Example campaign",
          "channelName": "EXAMPLE_CHANNEL",
          "processDate": "2026-01-15",
          "reportedDate": "2026-01-14",
          "spend": 320.75
        }
      ],
      "pageInfo": {
        "endCursor": "5000",
        "hasNextPage": true
      }
    }
  }
}
```