Skip to main content
Now that you have your access token, you are ready to make your first API call to test your access to the Nitro Sign API. Your first call will be a simple GET request that will fetch all the existing envelopes from your Nitro account.

​
Get Envelopes

Run the following curl command to fetch the envelopes associated with your account. Replace the <token> placeholder with a valid access token, either generated via code or extracted from your browser’s Application tab in the dev tools.

​
Request

curl --request GET \
  --url https://api.gonitro.dev/sign/envelopes \
  --header 'Authorization: Bearer <token>'

​
Response

Below is an example of the response you will get. items — A list of the envelopes you currently have in your account. nextPage — The next page cursor token to request further envelope entries. It doesn’t appear in the response if no more data is available. 
{
  "items": [
    {
      "ID": "123e4567-e89b-12d3-a456-426614174000",
      "archived": false,
      "createdAt": "2025-07-20T14:30:00Z",
      "lastModifiedAt": "2025-07-21T09:15:00Z",
      "name": "Contract Agreement - Client A",
      "status": "sent"
    },
    {
      "ID": "223e4567-e89b-12d3-a456-426614174001",
      "archived": true,
      "createdAt": "2025-06-10T08:45:00Z",
      "lastModifiedAt": "2025-07-01T17:00:00Z",
      "name": "NDA - Vendor B",
      "status": "sealed"
    },
    {
      "ID": "323e4567-e89b-12d3-a456-426614174002",
      "archived": false,
      "createdAt": "2025-07-18T11:20:00Z",
      "lastModifiedAt": "2025-07-19T16:05:00Z",
      "name": "Service Agreement - Partner C",
      "status": "drafted"
    }
  ],
  "nextPage": "eyJpZCI6MTIzLCJ0aW1lIjoiMjAyNC0wMS0xNVQxMDowMDowMFoifQ=="
}

​
Response types

200 Success Successful request with a list of envelopes. 401 Unauthorized If your access token is expired or invalid, you will receive a 401 Unauthorized response. If this happens, renew your access token and try again. If you continue getting the error after renewing the token, check the validity of the client_secret key that generated it.

​
Next steps

Once you complete this section, you are ready to start working on your Sign integration. We recommend following the Create Envelope tutorial in the Build section. It will guide you through how to create a Sign envelope, add resources to it, and send it for signing.