---
title: "List activity"
method: POST
path: "/activity"
tags: ["Activity"]
---

# List activity

`POST /activity`

## Request

- Base URL: `https://us.api.flexprice.io/v1`
- URL: `https://us.api.flexprice.io/v1/activity`
- Auth: API key in header `x-api-key`

Use when you need the audit trail of changes to billing entities: who changed what, when, from where. Filter by entity, customer, actor, action or request; pages are newest first.

## Request body

- ListActivityRequest
  - `actions` string[]
  - `actor_id` string
  - `actor_types` string[]
  - `cursor` string
  - `customer_id` string
  - `end_time` string, date-time
  - `entity_id` string
  - `entity_type` string
  - `expand` string[]
  - `limit` integer
  - `request_id` string
  - `start_time` string, date-time

## Response `200`

OK

- ListActivityResponse
  - `items` ActivityResponse[]
    - `action` string
    - `actor` ActivityActor
      - `id` string
      - `label` string
      - `type` string
    - `customer_id` string
    - `entity` ActivityEntity
      - `id` string
      - `label` string
      - `type` string
    - `id` string
    - `ip` string
    - `occurred_at` string, date-time
    - `request_id` string
    - `source` string
    - `state` object
    - `user_agent` string
  - `pagination` ActivityPagination
    - `has_more` boolean
    - `limit` integer
    - `next_cursor` string

## Other responses

- `400`: Invalid request
- `500`: Server error

## Changes

- **2026-10-13** `04daffd19a67`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/activity/post.md)

---

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