What an entry contains
You can identify a store either by ID or by name, and the service resolves the chain for you. That matters when feedback arrives from a channel that only knows the store’s display name.
Lifecycle
Feedback is a draft until it is completed. A customer can create an entry, change their mind, and finalise it later; only completed feedback is meaningful for analysis. Entries can also be deleted where a customer or a support process requires it. Use the feedback state (Open or Closed) when you need to know whether an entry is still editable without pulling the whole record.
Reporting
Two report shapes are available, and the service picks the granularity from the period you request.
Pre-generated reports can also be uploaded to blob storage when an external system needs to collect them rather than call the API.