GET

Data room details

https://www.helprange.com/api/v2/data-rooms/{data_room_id}

Guests (views, last visit, NDA status), documents, freeze status with closing archives, and Q&A counts.

Plans: Max, Unlimited, Deal Room Pass, trial. Auth: Authorization: Bearer hr_live_… (team key), X-API-Key, Authorization: Api-Key <key> or an OAuth Bearer token. Scope: rooms:read. Operation id: getDataRoom

Parameters

NameInTypeDescription
data_room_id requiredpathintegerData room id (from List data rooms). (min 1)

Example request

curl -X GET https://www.helprange.com/api/v2/data-rooms/10 \
  -H "X-API-Key: $HELPRANGE_API_KEY"

The samples read the key from the HELPRANGE_API_KEY environment variable.

Responses

StatusDescription
200OK
401Missing or invalid API key / OAuth token. Team keys: code invalid_key, key_revoked, key_expired or key_owner_removed.
402Your plan does not include the REST API (or this feature).
403The team API key lacks the scope this endpoint needs.
404Not found – or not yours (the API never says which).
405Wrong HTTP method for this endpoint.
429A usage limit was reached – wait Retry-After seconds.
Example response · 200
{
  "id": 10,
  "name": "Project Falcon",
  "nda_required": "Falcon NDA",
  "folders_enabled": true,
  "approval_workflow": false,
  "guests": [
    {
      "email": "buyer@bidco.com",
      "views": 23,
      "last_view_at": "2026-11-09T17:40:00+00:00",
      "nda": "signed",
      "nda_signed_at": "2026-11-02T10:00:00+00:00"
    }
  ],
  "pending_access_requests": 1,
  "documents": [
    {
      "id": 250,
      "name": "teaser.pdf",
      "views": 11,
      "room_link_id": 901,
      "room_folder_id": null,
      "room_folder": null,
      "group": null,
      "approval": "published"
    }
  ],
  "expires_at": null,
  "index_numbering": true,
  "freeze": {
    "frozen": false,
    "guest_access": "full",
    "frozen_at": null,
    "archives": []
  },
  "qa": {
    "available": true,
    "open_questions": 3,
    "questions": 12,
    "request_items": 40,
    "guests_can_ask": true,
    "answers_need_approval": false,
    "guests_see_request_list": true
  }
}

Try it

Uses your real account. The request goes from your browser straight to www.helprange.com with your API key and acts as you. The key stays in this page (in this tab's session storage only if you tick the box), is never put in a URL and is not sent to analytics. Do not paste a key on a shared computer.