Getting started with the REST API

Follow these steps to make a simple call to the REST API using curl in the command line.

1. Log in to Snyk.

2. In your account, use the left navigation to find an Organization where you have Projects you can list.

3. Navigate to your Organization Settings, and on the General settings page, find your Organization ID and copy the value.

4. Navigate to your personal General Account Settings and copy your API Token. For instructions, see Authentication for API.

5. Use a curl command to make your request. Replace the {orgId} and API_TOKEN with your Organization ID and API Token, respectively. Snyk recommends using 2024-10-15 for the version number unless you are using an earlier version for a specific reason. Using the current day's date will call the most recent version of the API. An example follows:

curl --request GET \
--url "https://api.snyk.io/rest/orgs/{orgId}/projects?version=2024-10-15" \
--header "Content-Type: application/vnd.api+json" \
--header "Authorization: token API_TOKEN"

The API URL to use when calling an API is different for different regions. For a complete list, see API URLs.

As an example, theSNYK-US-02region API URLs are the following:

• API V1: https://api.us.snyk.io/v1/

• REST API: https://api.us.snyk.io/rest/

Note that if you use the parameter target-reference, you must URL-encode it.

If you have any problems or questions, contact Snyk support.