> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rako.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommendations

> Record agent recommendations for attribution.

# Recommendations

A recommendation records that an agent presented an eligible offer to a user. It is the core attribution event in Rako.

```http theme={null}
POST /v1/recommend
Content-Type: application/json
```

## Request

```json theme={null}
{
  "session_id": "sess_...",
  "offer_id": "offer_...",
  "context": "Best value for a cheap rolling SIM with at least 10GB"
}
```

## Response

```json theme={null}
{
  "recommendation_id": "rec_...",
  "attribution_recorded": true,
  "fallback_url": "https://aap.link/r/..."
}
```

## Notes

* Create the recommendation when the agent actually recommends the offer, not when the user clicks a link.
* Include concise context explaining why the offer was recommended.
* Use the returned recommendation ID when initiating checkout.