---
title: "Usage Report"
method: GET
path: "/calls/history"
tags: ["Account Information"]
---

# Usage Report

`GET /calls/history`

## Request

- Base URL: `https://api.pitchbook.com`
- URL: `https://api.pitchbook.com/calls/history`
- Auth: API key in header `Authorization`

Retrieves information concerning calls made during the specific timeframe (for up to the last 30 days).

## Query parameters

- `sinceDate` string
- `trailingRange` integer

## Response `200`

OK

- EndpointUsageReportDto
  - `stats` EndpointUsageStatsDto
    - `endpoints` string[]
    - `totalCountOfCalls` integer
    - `totalChargedCredits` integer
  - `rawData` EndpointUsageInfoDto[]
    - `contractNumber` string
    - `request` string
    - `requestDate` string, date-time
    - `responseStatus` string
    - `endpointType` string
    - `chargedCredits` integer

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

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