List all opportunities

Endpoint and Request Method: GET /api/opportunities/ This endpoint retrieves a paginated list of all opportunities for the authenticated institution.

Example Request: GET https://api.vomevolunteer.com/api/opportunities/

Authorization: Requests to this endpoint require 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/",
    headers=headers
)

Response Structure: The response is a paginated object containing opportunity records. Each record represents a single opportunity along with its related category details and share URL.

Response Object:

{
  "count": 2,
  "next": "https://api.vomevolunteer.com/api/opportunities/?page=2",
  "previous": null,
  "results": [
    {
      "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.vomevoluteer.com/opportunity-board/test%20organization/weekend%20mentor/2f56f3ef-08f5-4e5a-bf5b-76ca8fc4d5f1"
    },
    {
      "id": "ad7a99da-94c5-4e3f-8c6f-c2c8c7eb0a74",
      "category": {
        "id": "4a17144c-58c8-4103-8c0a-f2ac12079e7a",
        "title": "Food Services",
        "description": "Meal prep and food distribution roles."
      },
      "title": "Kitchen Support",
      "description": "Assist staff with packaging and cleanup.",
      "share_opportunity_url": null
    }
  ]
}