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://api.vomevolunteer.com/api/share/opportunity/73bb56fa-6c7f-4fce-ad5a-32eb1ba215a6"
}Last updated