Make your first call

Prerequisites

API credentials from your Nitro delivery team - see Platform Access
Your tenant’s base URL

Prefer an interactive panel? On any API reference page, click Try it to open the request panel, set your base URL and authentication, and send the request live against your tenant - no curl required.

Set your base URL

Set your base URL as an environment variable. All examples on this page use BASE_URL:

export BASE_URL="https://your-tenant.sign.gonitro.com/esig/webportalapi/v4"

Make the request

Call GET /documentGroups - a read-only endpoint that returns the available document groups. It is a safe way to verify that your credentials and base URL are correct.

curl "$BASE_URL/documentGroups" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "User-Agent: MyApp/1.0"

curl "$BASE_URL/documentGroups" \
  -H "Authorization: Bearer {access_token}" \
  -H "User-Agent: MyApp/1.0"

See Authentication for how each method works and which OAuth2 flow applies to your integration.

Verify the response

A successful response returns the configured document groups:

{
  "DocumentGroups": [
    {
      "Name": "My Documents",
      "Code": "00001"
    }
  ]
}

Troubleshoot common errors

Response	Likely cause
`401 Unauthorized`	Credentials are incorrect or the `Authorization` header is malformed
`404 Not Found`	Base URL is wrong - make sure the path includes the `esig` segment, and double-check the host with your delivery team
Connection refused	Wrong host or port - confirm your base URL

Next steps

Send a document for signing

Follow the end-to-end tutorial to build your first signing workflow.

Credentials & AuthenticationThe two authentication methods of the NSEV WebPortal API - Basic Auth and OAuth 2.0 - and when to use each.

Getting Started Guide

Authentication & Authorization

Make your first API call

Make your first call

Prerequisites

Set your base URL

Make the request

Verify the response

Troubleshoot common errors

Next steps

Send a document for signing

​Prerequisites

​Set your base URL

​Make the request

​Verify the response

​Troubleshoot common errors

​Next steps

Send a document for signing

Prerequisites

Set your base URL

Make the request

Verify the response

Troubleshoot common errors

Next steps