# List Analytics

**GET** `/v1/lists/{{list_id}}/analytics`

Cross-references this list's members against Postal email send records for a given `email_type`. Returns engagement counts and rates for members of this specific list only — recipients outside the list are excluded.

### Query parameters

**email_type** `string` `required` — The email type to analyse (e.g. `spring_promo`, `order_cancelled`).

### Response fields

**list_id** Unique identifier of the list.  
**list_name** Name of the list.  
**list_size** Total number of members in the list.  
**email_type** The email type queried.  
**sent** Number of list members who were sent this email.  
**delivered** Number of list members who received this email.  
**opened** Number of list members who opened this email.  
**clicked** Number of list members who clicked a link in this email.  
**open_rate** Percentage of sent emails that were opened (0–100).  
**click_rate** Percentage of sent emails that were clicked (0–100).  
**delivery_rate** Percentage of sent emails that were delivered (0–100).

> Stats are `null` if the email analytics service is unreachable.