> For the complete documentation index, see [llms.txt](https://docs.vomevolunteer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vomevolunteer.com/resources/editor-5/retrieve-a-opportunity.md).

# Retrieve a opportunity

**Endpoint**\
`GET /api/opportunities/{opportunity_id}/`

Replace `{opportunity_id}` with the actual ID of the opportunity role you wish to retrieve.

**Example Request**\
`GET /api/opportunities/2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1/`

**Authorization**\
Requests to this endpoint must include an `API-KEY` in the header for authentication:

```python
headers = {"API-KEY": "your_unique_api_key_here"}

response = requests.get(
    "https://api.vomevolunteer.com/api/opportunities/2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1/",
    headers=headers
)
```

**Response Object**\
The response object includes details about a single opportunity role, including its related category and share URL:

```json
{
  "id": "2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1",
  "created_at": "2026-02-05T07:40:29.324645Z",
  "category": {
    "id": "d610ab31-e480-4ef1-9e35-94f94ebacde9",
    "title": "Community Outreach",
    "description": "Programs and roles related to outreach work."
  },
  "title": "Weekend Mentor",
  "description": "Support volunteers during weekend sessions.",
  "share_opportunity_url": "https://api.vomevolunteer.com/api/share/opportunity/73bb56fa-6c7f-4fce-ad5a-32eb1ba215a6"
}
```