Case List

Use this endpoint to list cases for a company. You can filter by status, folder, and paginate the result set.

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}/cases/get

Path Parameters

Parameter	Type	Description
`company`	`string`	Your company identifier

Query Parameters

Parameter	Type	Description
`status`	`string`	Filter by signing status: `signed`, `denied`, or `pending`
`limit`	`number`	Maximum number of cases to return. Default is `100`
`index`	`number`	Zero-based page index used together with `limit`
`folder`	`string`	Filter by folder name

Example Request

cURL

curl --location 'https://www.nextsign.dk/api/v2/{company}/cases/get?status=signed&limit=10&index=0&folder=Default' \
  -H 'Authorization: Bearer YOUR_API_KEY'

JavaScript

const params = new URLSearchParams({
  status: 'signed',
  limit: '10',
  index: '0',
  folder: 'Default'
});

const response = await fetch(
  `https://www.nextsign.dk/api/v2/{company}/cases/get?${params}`,
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();

Python

import requests

url = "https://www.nextsign.dk/api/v2/{company}/cases/get"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}
params = {
    "status": "signed",
    "limit": 10,
    "index": 0,
    "folder": "Default"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

Example Response

200 OK

{
  "status": "company_found",
  "cases": [
    {
      "_id": "657b2ffb0965b111023fb0d1",
      "title": "Contract Agreement",
      "folder": "Default",
      "createdAt": "2023-12-14T16:40:27.431Z",
      "updatedAt": "2024-02-19T10:52:25.836Z"
    }
  ]
}

Response Fields

Field	Type	Description
`status`	`string`	Status of the lookup, typically `company_found`
`cases`	`array`	Array of matching case objects

The API returns 404 when no cases match the filter.

Common Error Responses

Invalid company id:

{
  "code": 400,
  "message": "Bad Request",
  "description": "Invalid company id"
}

No matching cases:

{
  "message": "Case not found"
}