---
title: "Get All Opportunities"
method: GET
path: "/api/v2/opportunities"
tags: ["Opportunity"]
---

# Get All Opportunities

`GET /api/v2/opportunities`

This endpoint retrieves all opportunities for the current organization. <h3>Required Scope</h3>`opportunity:read` or `opportunity:write`

## Query parameters

- `next` string
- `limit` integer
- `filter[start_date]` string, date
- `filter[end_date]` string, date
- `filter[status]` string

## Response `200`

Success

- ListedOpportunity
  - `links` SelfWithNextLink
    - `self` string
    - `next` string
  - `data` OpportunityAttributes[]
    - `type` string, nullable
    - `id` string, nullable
    - `attributes` OpportunityAttributesAttributes
      - `degreed-url` string, nullable — URL location of the opportunity within Degreed UI.
      - `provider` string, nullable — Unique provider code.
      - `title` string, nullable — The title of the opportunity.
      - `description` string, nullable — The description of the opportunity.
      - `category` string, nullable — The category for the opportunity. For example, `Full time`, `Temp`, etc.
      - `department` string, nullable — The department of the opportunity.
      - `job-role` string, nullable — Must correspond to the name of a plan in order to be valid. The `name` attribute of the GET /skill-plans endpoint resource with `plan-type: Role` can be used.
      - `start-date` string, date-time, nullable — The start date of the opportunity. (UTC)
      - `end-date` string, date-time, nullable — The end date of the opportunity. (UTC)
      - `duration` number, double, nullable — The duration of the opportunity.
      - `status` string, nullable — The status of the opportunity. Can only be `open` or `closed`.
      - `duration-units` string, nullable — Must be one of the following: `EndDate`, `Years`, `Months`, `Weeks`, `Days`, `Hours`, `Seconds`, or `Unknown`.
      - `location` string, nullable — The location of the opportunity.
      - `visibility` string, nullable — Can only be `Private` or `Organization`.
      - `external-id` string, nullable — The external identifier of the opportunity.
      - `url` string, nullable — URL location where more information can be found.
      - `image-url` string, nullable — Cover image of the opportunity.
      - `is-obsolete` boolean
      - `created-at` string, date-time — The date the opportunity was created. (UTC)
      - `modified-at` string, date-time — The date the opportunity was last modified. (UTC)
    - `links` SelfLink
      - `self` string

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)