Skip to main content
GET
/
api
/
v2
/
history
/
usage
Get Usage History (v2)
curl --request GET \
  --url https://api.harvey.ai/api/v2/history/usage \
  --header 'Authorization: Bearer <token>'
{
  "events": [
    {
      "access_point": "WEB",
      "action": "CREATE",
      "cm_id": "019074a2-943b-7b30-884d-baf60d401c98",
      "file_ids": [
        "019d35f0-4cf5-7296-aef5-45991d83a77b",
        "019d35f0-4cf1-7f4f-a09b-885f9066638e"
      ],
      "parent_thread_id": 2374992,
      "playbook_name": "",
      "product_surface_area": "ASSISTANT",
      "review_table_name": "Supply Agreement Details and Key Terms",
      "source": "Files",
      "space_name": "",
      "subsurface": "ASSISTANT_THREAD, ASSISTANT_THREAD_FOLLOWUP",
      "utc_time": "2026-02-22 14:01:23",
      "unique_usage_id": "019c85a7-a7c9-784f-bc59-0ddd5654274d",
      "user": "user@example.com",
      "vault_project_name": "48CommercialContracts",
      "workflow_name": "",
      "metadata": {
        "num_columns": 5,
        "num_files": 48
      }
    }
  ]
}

​
Permissions

Requires Territory admin or Organization admin, and View history permissions.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
start_time
integer<date-time>
required

UTC epoch timestamp, up to 1 year ago from now

​
end_time
integer<date-time>
required

UTC epoch timestamp, up to 30 days from start_time. Note: The API supports a maximum range of 30 days, but it's best to retrieve a max of one day at a time on a regular cadence.

​
include_file_ids
boolean
default:false

When set to true, the response will include file_ids for each event. This may impact performance, so only enable when needed (e.g., to use with the file download endpoint).

Response

Object containing an array of V2UsageHistory events

​
events
object[]

Array of usage history events.