---
title: "Get a specific portfolio"
method: GET
path: "/users/{user_id}/portfolios/{portfolio_id}"
tags: ["Portfolios\\Essentials"]
---

# Get a specific portfolio

`GET /users/{user_id}/portfolios/{portfolio_id}`

## Request

- Base URL: `https://api.vimeo.com`
- URL: `https://api.vimeo.com/users/{user_id}/portfolios/{portfolio_id}`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`, token URL `/oauth/access_token`
  - Client credentials, token URL `/oauth/authorize/client`
  - Scopes: `create`, `delete`, `edit`, `email`, `interact`, `private`, `promo_codes`, `public`, `purchase`, `purchased`, `stats`, `upload`, `video_files`
- TypeScript: <https://skmtc.dev/vimeo/apis/vimeo-api/docs/users/:user_id/portfolios/:portfolio_id/get.ts> (a function with typed inputs; its response is checked against the schema)

This method gets a single portfolio from the specified user.

## Path parameters

- `portfolio_id` number, required
- `user_id` number, required

## Response `200`

The portfolio was returned.

- Portfolio
  - `created_time` string, required: The time in ISO 8601 format when the portfolio was created.
  - `description` string, nullable, required: The portfolio's description.
  - `link` string, required: The link to the portfolio.
  - `metadata` object, required: Metadata about the album.
    - `connections` object, required: A list of resource URIs related to the album.
      - `videos` object, required: Information about the videos contained within this portfolio.
        - `options` string[], required: An array of HTTP methods permitted on this URI.
        - `total` number, required: The total number of videos on this connection.
        - `uri` string, required: The API URI that resolves to the connection data.
  - `modified_time` string, required: The time in ISO 8601 format when the portfolio's data was last modified.
  - `name` string, required: The display name of the portfolio.
  - `sort` 'alphabetical' | 'clips' | 'modified' | 'recent', required: The default video sort order for the portfolio: Option descriptions: * `alphabetical` - The default sort order is alphabetical by name. * `clips` - The default sort order is video creation date. * `modified` - The default sort order is the order in which the videos were modified. * `recent` - The default sort order is the order in which the videos were added.
  - `uri` string, required: The canonical relative URI of the portfolio.

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) - [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vimeo/apis/vimeo-api/revisions/ea882e0224a4?raw)