Developer / API / Endpoints

api.vimeo.com/authenticationextras

Authentication Extras

Convert OAuth 1 access tokens to OAuth 2 access tokens

POST https://api.vimeo.com/oauth/authorize/vimeo_oauth1 Playground
Name Type Required Description
grant_type enum
  • vimeo_oauth1
 Yes

Grant type. Must be set to "vimeo_oauth1".
token string Yes

OAuth 1 token
token_secret string Yes

OAuth 1 token secret
HTTP Status Code Explanation
200 OK

400 Bad Request

If the supplied token is invalid.
400 Bad Request

If the supplied token has unauthorized scopes.

Exchange an authorization code for an access token

POST https://api.vimeo.com/oauth/access_token Playground
Name Type Required Description
code string Yes

The authorization code received from the authorization server.
grant_type enum
  • authorization_code
 Yes

Grant type. Must be "authorization_code".
redirect_uri string Yes

URI to redirect the user to. Must match the redirect URI from /oauth/authorize.
HTTP Status Code Explanation
200 OK

400 Bad Request

If an unsupported grant type is used.
400 Bad Request

If the given authorization code is invalid.
400 Bad Request

If the provided redirect_uri does not match the URI to create the authorization code.

OAuth client authorization

POST https://api.vimeo.com/oauth/authorize/client Playground
Name Type Required Description
grant_type enum
  • client_credentials
 Yes

Grant type. Must be set to "client_credentials".
scope string Yes

This is a space-separated list of scopes you want to access. Defaults to "public".
HTTP Status Code Explanation
200 OK

Revoke the current access token

DELETE https://api.vimeo.com/tokens Playground
HTTP Status Code Explanation
204 No Content

400 Bad Request

If you attempt this for an oAuth1 token.

Verify an OAuth 2 token

GET https://api.vimeo.com/oauth/verify Playground
HTTP Status Code Explanation
200 OK

401 Unauthorized

If the provided token is not a valid OAuth 2 token.
Send Feedback