> 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/list-all-opportunities.md).

# 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.

```python
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:**

```json
{
  "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://api.vomevolunteer.com/api/share/opportunity/73bb56fa-6c7f-4fce-ad5a-32eb1ba215a6"
    },
    {
      "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": "https://api.vomevolunteer.com/api/share/opportunity/73bb56fa-6c7f-4fce-ad5a-32eb1ba215a6"
    }
  ]
}
```