Skip to content

Most visited

Recently visited



public abstract @interface RequiresApi
implements Annotation

Denotes that the annotated element should only be called on the given API level or higher.

This is similar in purpose to the older @TargetApi annotation, but more clearly expresses that this is a requirement on the caller, rather than being used to "suppress" warnings within the method that exceed the minSdkVersion.


Public methods

int api()

The API level to require

int value()

The API level to require.

Inherited methods

From interface java.lang.annotation.Annotation

Public methods


int api ()

The API level to require


Value is 1 or greater.


int value ()

The API level to require. Alias for api() which allows you to leave out the api= part.


Value is 1 or greater.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields


Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience. (Dec 2017 Android Platform & Tools Survey)