Common Errors
How can I provide Vimeo with my full API request and response?
If you’d like to contact us about errors you encounter, please provide us with the full API request and response. We highly recommend you use runscope.com for this task. They provide amazing tools to track down and share this information!
The resource was not found.
The resource you are attempting to locate through the API does not exist, or is not viewable by the authenticated user.
The user is not allowed to perform that action.
The authenticated user does not have permission to perform the requested action. If you believe this is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
The app is not allowed to perform that action.
The API Application does not have permission to perform the requested action. If you believe you should have permission, contact us at https://vimeo.com/help/contact with your full request and response.
The sort passed is not valid for this resource.
Your sort parameter is not accepted by the requested endpoint. You can find all valid fields at https://developer.vimeo.com/api/endpoints. If you believe the documentation or API is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
You have provided an invalid filter parameter.
Your filter parameter is not accepted by the requested endpoint. You can find all valid filters at https://developer.vimeo.com/api/endpoints. If you believe the documentation or API is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
A valid user token must be passed.
The request you have attempted must be made with an authenticated access token. To learn more, please read our authentication documentation: https://developer.vimeo.com/api/authentication.
You provided an invalid parameter.
One of the parameters you provided was not accepted by the API endpoint. For more information, please check out our endpoint documentation: https://developer.vimeo.com/api/endpoints. If you believe the documentation or API is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
Your HTTP Method is not supported on this endpoint.
The HTTP method you used in this API request is not accepted on the requested endpoint. To see all valid HTTP methods, check out the endpoint documentation: https://developer.vimeo.com/api/endpoints. If you believe the documentation, or API is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
Unsupported response format provided via the accept header.
The value provided in your accept header could not be understood by the API. Please refer to our versioning documentation: https://developer.vimeo.com/api/spec#version. If you believe the documentation or API is incorrect, please contact us at https://vimeo.com/help/contact with your full request and response.
You have made an invalid request. Please double check the documentation.
A requirement of this API endpoint was not met with your request. Consult the API documentation for this request for more information, or contact us at https://vimeo.com/help/contact with your full request and response.
This endpoint has been temporarily disabled. Try again soon, and check the developer site for more information.
Vimeo has temporarily disabled the endpoint you are attempting to request. This is likely due to system maintenance, or unexpected downtime. Please see our status page (status.vimeo.com) for more information, or contact us at https://vimeo.com/help/contact.
An internal server error has occurred. Let us know and please try again.
An error occurred that Vimeo has not anticipated or is unable to handle properly. Please contact us with your full request and response immediately so we can improve the reliability of the API. Thanks!
An error has occurred when finalizing the video. Let us know and please try again.
At the final step of the upload process, Vimeo encountered an error. This could be because the file is not a video, was not completely uploaded, or for many other reasons. If you have questions, or need help debugging, please contact us at https://vimeo.com/help/contact with your full request and response.
A payment is required for this resource.
The resource you are attempting to request (likely a Vimeo On Demand video) has not been purchased by the authenticated user, so you cannot access it. Vimeo On Demand content should be accessed through the On Demand resources, which are explained in further detail at https://developer.vimeo.com/api/endpoints/ondemand.
Your access token does not have the necessary scopes.
The API endpoint you requested requires your token to be authorized with additional API scopes. For more information, please check out our authentication documentation: https://developer.vimeo.com/api/authentication#scopes.
Can’t find what you’re looking for? Try searching:
Still stumped? Email us or visit the Forums.