---
title: "Aggregate asset photos"
method: GET
path: "/asset_photos/aggregate"
tags: ["asset_photos"]
---

# Aggregate asset photos

`GET /asset_photos/aggregate`

## Request

- Base URL: `https://app.torgix.ai/v1`
- URL: `https://app.torgix.ai/v1/asset_photos/aggregate`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.torgix.ai/oauth/authorize`, token URL `https://app.torgix.ai/oauth/token`, scopes: `read`)

One number, or one number per group, over the same filters as the list. `metric` is `count` or `sum:col`, `avg:col`, `min:col`, `max:col`; add `group_by=col` for up to 1000 groups, largest first.

## Query parameters

- `metric` string, required
- `group_by` string
- `changed_since` string, date-time
- `include_deleted` boolean

## Response `200`

The metric.

- object
  - `data` union
    - object
      - `value` number
    - object[]
      - `group` unknown
      - `value` number
  - `metric` string
  - `group_by` string
  - `request_id` string

## Other responses

- `400`: Malformed request: bad JSON, empty body, bad batch, bad id, or an invalid metric or group_by.
- `401`: Missing or invalid credentials.
- `403`: API access not enabled for the account, missing scope, or IP not allowlisted.
- `429`: Per-second rate limit exceeded.

---

[API](https://skmtc.dev/torgix/apis/torgix-api.md) · [All operations](https://skmtc.dev/torgix/apis/torgix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/torgix/apis/torgix-api/revisions/e675a45c026d?raw)