# GET /opportunities/:id

**Resource:** [Opportunities](./opportunities.md)  
**Scopes:** `opportunities:read`  
**Write operation:** no

Retrieve a single opportunity by ID with pipeline placements. Supports expansions. Legacy alias: GET /deals/:id.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Opportunity ID |
| `expand` | query | string | no | Expansions: contact, referrer, customer, products, assigned_users. "referrer" inlines the referrer contact (id, public_id, first_name, last_name, email, phone, job_title) when primary_referrer_contact_id is set. |

## Response example

```json
{
  "data": {
    "id": "opp-uuid",
    "name": "Radiology Referral -- John Smith",
    "status": "open",
    "primary_referrer_contact_id": "referrer-contact-uuid",
    "primary_referrer_category": "CT",
    "referrer": {
      "id": "referrer-contact-uuid",
      "public_id": "CONT-042",
      "first_name": "Dr",
      "last_name": "Smith",
      "email": "dr.smith@clinic.com.au",
      "phone": "+61285551234",
      "job_title": "Radiologist"
    },
    "placements": [...]
  },
  "meta": { "credits_remaining": 9499 }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`