---
title: Stats
summary: Stats give you information on the usage and performance of your Service. They can be requested by Service and over a particular time span. Stats are broken down per POP, giving you information on how your Services are being used across the world. There is now a more flexible, and fully featured <a href="https://www.fastly.com/documentation/reference/api/metrics-stats/historical-stats/">Stats API</a> available.
url: https://www.fastly.com/documentation/reference/api/metrics-stats/stats
---

Stats give you information on the usage and performance of your Service. They can be requested by Service and over a particular time span. Stats are broken down per POP, giving you information on how your Services are being used across the world. There is now a more flexible, and fully featured <a href="https://www.fastly.com/documentation/reference/api/metrics-stats/historical-stats/">Stats API</a> available.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `stats` | object |  |

## API endpoints

### Get stats for a service

**GET** `/service/{service_id}/stats/summary`

Get the stats from a service for a block of time. This lists all stats by PoP location, starting with AMS. This call requires parameters to select block of time to query. Use either a timestamp range (using start_time and end_time) or a specified month/year combo (using month and year).

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `end_time` | integer | query | No | Epoch timestamp. Limits the results returned. |
| `month` | string | query | No | 2-digit month. |
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `start_time` | integer | query | No | Epoch timestamp. Limits the results returned. |
| `year` | string | query | No | 4-digit year. |