---
agentTools:
  projectIndex: https://developer.bill.com/llms.txt
---

# Webhook improvements

### Webhooks Time To Live (TTL)

BILL maintains an event history for each subscription. We have now upgraded the webhooks TTL from `90` days to `180` days. You can get the list of event notifications sent to you for a subscription with `GET /v3/events/subscription/{subscription_id}`. You can now get the list of events for the last `180` days.

See [Webhook API notification rules](https://developer.bill.com/docs/bill-webhook-api-notification-rules) for more information about the complete set of rules.

### Get list of event notifications improvements

We have added the capability for filtering event notifications by an entity ID. For example, to get notifications for a specific bill, you can now filter with the ID of the bill.

In the Get list of event notifications (`GET /v3/events/subscription/{subscription_id}`) request, you can now filter event notifications with the `entityId` field.

| Field      | Description                                                                                                                                             |
| :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `entityId` | BILL-generated ID of the entity, such as bill or vendor. For example, to filter notifications by a specific bill, set this value as the ID of the bill. |

See [GET /v3/events/subscription/\{subscriptionId}](https://developer.bill.com/reference/geteventsforsubscription) in the API reference for more information.