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 Public API. Your first call will be a simple GET request that will fetch all the existing envelopes from your Nitro account. Here you can check the OpenAPI spec for this endpoint.

​
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. The response will have the following fields: 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 get a 401 status code for Unauthorized access. 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 them.

​
Next steps

Once you complete this section, you are ready to start working on your 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 deploy it. This is a common task when implementing an integration with Nitro.
⌘I