publ betaReference (MCP guide)
Open publ console

messenger_gift_history_get

# messenger_gift_history_get

Read received gift history in the Messenger app (pApp D00003). View page or cursor with optional roomUuid, purchaser or receiver filters (the console has no single-gift view). Optional includeReactions and profile names. Returns the inventory IDs messenger_gift_reactions_get takes. Changes nothing.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `view` | Yes | one of: `cursor`, `page` |
| `roomUuid` | No | When `view` is `cursor`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `purchaserProfileDistinctId` | No | When `view` is `cursor`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `receiverProfileDistinctId` | No | When `view` is `cursor`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `includeReactions` | No | When `view` is `cursor`: boolean; default `false` |
| `includePurchaserProfiles` | No | When `view` is `cursor`: boolean; default `false` |
| `includeReceiverProfiles` | No | When `view` is `cursor`: boolean; default `false` |
| `after` | No | When `view` is `cursor`: integer; greater than 0 |
| `first` | No | When `view` is `cursor`: integer; maximum 100; greater than 0; default `20` |
| `roomUuid` | No | When `view` is `page`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `purchaserProfileDistinctId` | No | When `view` is `page`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `receiverProfileDistinctId` | No | When `view` is `page`: string; pattern `^[A-Za-z0-9_-]{1,200}$` |
| `includeReactions` | No | When `view` is `page`: boolean; default `false` |
| `includePurchaserProfiles` | No | When `view` is `page`: boolean; default `false` |
| `includeReceiverProfiles` | No | When `view` is `page`: boolean; default `false` |
| `page` | No | When `view` is `page`: integer; greater than 0; default `1` |
| `limit` | No | When `view` is `page`: integer; maximum 100; greater than 0; default `20` |