{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"\nThis endpoint returns day-over-day changes in billing resource usage based on nightly invoice items, including total amount, region, SKU, and description for a specified date range. It is important to note that the daily resource usage may not reflect month-end billing totals when totaled for a given month as nightly invoice item estimates do not necessarily encompass all invoicing factors for the entire month.","properties":{"path":{"type":"object","properties":{"account_urn":{"type":"string","examples":["do:team:12345678-1234-1234-1234-123456789012"],"description":"URN of the customer account, can be a team (do:team:uuid) or an organization (do:teamgroup:uuid)"},"start_date":{"type":"string","format":"date","examples":["2025-01-01"],"description":"Start date for billing insights in YYYY-MM-DD format"},"end_date":{"type":"string","format":"date","examples":["2025-01-31"],"description":"End date for billing insights in YYYY-MM-DD format. Must be within 31 days of start_date"}},"required":["account_urn","start_date","end_date"],"additionalProperties":false},"query":{"type":"object","properties":{"per_page":{"type":"integer","minimum":1,"default":20,"maximum":200,"examples":[2],"description":"Number of items returned per page"},"page":{"type":"integer","minimum":1,"default":1,"examples":[1],"description":"Which 'page' of paginated results to return."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"List Billing Insights","id":"digitalocean.billinginsights_list","example":{"path":{"account_urn":"do:team:12345678-1234-1234-1234-123456789012","start_date":"2025-01-01","end_date":"2025-01-31"}},"maxRequests":1,"summary":false}}