VantageKitVantageKit Docs

List deal rooms

Returns a paginated list of deal rooms belonging to your team, sorted by most recently updated. Each deal room includes computed counts for documents, links, and total views.

GET
/deal-rooms

Authorization

AuthorizationBearer <token>

Pass your API key as a Bearer token.

Authorization: Bearer vk_live_aBcDeFgHiJkLmNoPqRsTuVwXyZ012345

In: header

Query Parameters

page?integer

Page number (1-indexed).

Default1
Range1 <= value
per_page?integer

Items per page (max 100).

Default20
Range1 <= value <= 100
status?string

Filter by deal room status.

Value in"active" | "archived"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.vantagekit.com/v1/deal-rooms"
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Series A Fundraising",
      "description": "Materials for Series A pitch",
      "status": "active",
      "documentCount": 5,
      "linkCount": 2,
      "totalViews": 23,
      "createdAt": "2026-03-01T10:00:00Z",
      "updatedAt": "2026-04-08T15:30:00Z"
    }
  ],
  "meta": {
    "apiVersion": "2026-04-01",
    "pagination": {
      "page": 1,
      "perPage": 20,
      "total": 1,
      "totalPages": 1
    }
  }
}
{
  "error": "API key is required",
  "code": "unauthorized"
}
{
  "error": "Rate limit exceeded",
  "code": "rate_limit"
}
{
  "error": "An unexpected error occurred",
  "code": "internal_error"
}