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:

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:

{
  "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://www.frontend.com/opportunity-board/test%20organization/weekend%20mentor/2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1"
}