Case Get

Use this endpoint to fetch a single case by its unique identifier.

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}/case/{case_id}/get

Path Parameters

Parameter	Type	Description
`company`	`string`	Your company identifier
`case_id`	`string`	Unique identifier of the case

Example Request

cURL

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

JavaScript

const response = await fetch(
  'https://www.nextsign.dk/api/v2/{company}/case/657b2ffb0965b111023fb0d1/get',
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();

Python

import requests

url = "https://www.nextsign.dk/api/v2/{company}/case/657b2ffb0965b111023fb0d1/get"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

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

Example Response

200 OK

{
  "status": "case_found",
  "case": {
    "settings": {
      "deletion": {
        "autoDelete": true,
        "days": 30
      },
      "availability": {
        "days": 10,
        "isExpired": false,
        "unlimited": false
      },
      "reminders": {
        "amount": 2,
        "daysBetween": 3,
        "send": true
      },
      "allowAPI": false,
      "allowedRoles": []
    },
    "_id": "657b2ffb0965b111023fb0d1",
    "user_name": "Daniel Prior",
    "user_email": "123@live.dk",
    "title": "Example Agreement",
    "referenceId": "REF-48392",
    "state": "open",
    "type": "Simple sign",
    "createdAt": "2023-12-14T16:40:27.431Z",
    "updatedAt": "2024-02-19T10:52:25.836Z"
  }
}

Response Fields

Field	Type	Description
`status`	`string`	Status of the request, typically `case_found`
`case`	`object`	Case object containing the current case data
`case._id`	`string`	Unique case identifier
`case.title`	`string`	Case title
`case.referenceId`	`string`	Internal reference identifier
`case.state`	`string`	Current lifecycle state such as `open`, `completed`, or `denied`
`case.type`	`string`	Case type
`case.createdAt`	`string`	ISO 8601 creation timestamp
`case.updatedAt`	`string`	ISO 8601 update timestamp
`case.settings`	`object`	Case settings, including reminders and availability

Shared object reference: Settings Object and Case States.

Common Error Responses

Invalid company id:

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

Case not found:

{
  "message": "Case not found"
}