Forms Get

Use this endpoint to retrieve a single form and inspect its settings, recipients, tags, and attached documents.

Authorization

All requests to this endpoint require authentication using a Bearer Token.

Use your NextSign API key as the bearer token for this endpoint.

Endpoint

GET https://www.nextsign.dk/api/v2/{company}/forms/{form_id}/get

Path Parameters

Parameter	Type	Description
`company`	`string`	Your company identifier
`form_id`	`string`	Unique identifier of the form

Example Request

cURL

curl --location 'https://www.nextsign.dk/api/v2/{company}/forms/{form_id}/get' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

200 OK

{
  "_id": "65f493fb52bb6d8baa5d16af",
  "companyId": "6576e19662ec13c4faa7de7b",
  "folder": "Default",
  "active": true,
  "title": "Example Form",
  "settings": {
    "deletion": {
      "autoDelete": true,
      "days": 30
    },
    "availability": {
      "unlimited": false,
      "days": 10,
      "isExpired": false
    },
    "reminders": {
      "send": true,
      "amount": 2,
      "daysBetween": 3
    },
    "allowAPI": true
  },
  "tags": [],
  "recipients": [],
  "documents": []
}

Response Fields

Field	Type	Description
`_id`	`string`	Unique form identifier
`companyId`	`string`	Company identifier
`title`	`string`	Form title
`folder`	`string`	Folder name where the form is stored
`active`	`boolean`	Whether the form is active
`settings`	`object`	Form configuration settings
`tags`	`array`	Form tag definitions
`recipients`	`array`	Recipient configuration
`documents`	`array`	Documents attached to the form

Common Error Responses

Form not found:

{
  "errors": [
    {
      "code": 400,
      "message": "Bad Request",
      "description": "Form not found"
    }
  ]
}

Server error:

{
  "message": "Internal server error",
  "errors": []
}