Developers

Access your Totem data programmatically through our REST API. Build integrations, automate workflows, and connect Totem with your existing tools.

Base URL

api.totemvc.com/v1

Rate Limit

100 req / min

Authentication

Authenticate requests by including your API key in the Authorization header as a Bearer token. Generate API keys from your Totem dashboard under Settings → API Keys.

Example Request

curl https://api.totemvc.com/v1/portfolio \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

All responses return JSON. List endpoints support pagination via limit (default: 50, max: 200) and offset query parameters.

Example Response

{
  "data": [
    {
      "id": "co_abc123",
      "name": "Acme Corp",
      "status": "active"
    }
  ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

Endpoints

Timeline

GET/v1/timeline

Activity timeline across portfolio and deals

Parameters

Name	Type	Description
`tab`	`string`	Timeline scope: portfolio or deals (default: "portfolio")
`startDate`	`string`	Start date (YYYYMMDD)
`endDate`	`string`	End date (YYYYMMDD)

Portfolio

GET/v1/portfolio

List portfolio companies

Parameters

Name	Type	Description
`limit`	`integer`	Number of results to return (default: 50, max: 200)
`offset`	`integer`	Pagination offset (default: 0)

GET/v1/portfolio/:id

Get a single portfolio company

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)

GET/v1/portfolio/:id/financials

Retrieve financial metrics

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)
`year`	`string`	Fiscal year, "all", or "ltm" (default: "all")
`granularity`	`string`	Period granularity: year, half, quarter, month
`scenario`	`string`	Scenario filter: all, actual, budget, forecast (default: "all")
`currency`	`string`	Override display currency (e.g. "USD", "EUR")

GET/v1/portfolio/:id/transactions

List investment transactions

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)

GET/v1/portfolio/:id/valuations

Access valuation history

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)

GET/v1/portfolio/:id/captable

View capitalization tables

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)

GET/v1/portfolio/:id/interactions

List meetings and emails

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)
`type`	`string`	Filter by interaction type (meeting, email)

GET/v1/portfolio/:id/notes

Retrieve notes

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)

GET/v1/portfolio/:id/news

Portfolio company news

Parameters

Name	Type	Description
`id`required	`string`	Portfolio company ID (path parameter)
`limit`	`integer`	Number of results to return (default: 50, max: 200)
`offset`	`integer`	Pagination offset (default: 0)

Deals

GET/v1/deals

List deals in pipeline

Parameters

Name	Type	Description
`limit`	`integer`	Number of results to return (default: 50, max: 200)
`offset`	`integer`	Pagination offset (default: 0)

GET/v1/deals/:id

Get a single deal

Parameters

Name	Type	Description
`id`required	`string`	Deal ID (path parameter)

Funds

GET/v1/funds

List fund structures

Parameters

Name	Type	Description
`limit`	`integer`	Number of results to return (default: 50, max: 200)
`offset`	`integer`	Pagination offset (default: 0)

GET/v1/funds/:id

Get a single fund

Parameters

Name	Type	Description
`id`required	`string`	Fund ID (path parameter)

LPs

GET/v1/lps

List limited partners

Parameters

Name	Type	Description
`limit`	`integer`	Number of results to return (default: 50, max: 200)
`offset`	`integer`	Pagination offset (default: 0)

GET/v1/lps/:id

Get a single limited partner

Parameters

Name	Type	Description
`id`required	`string`	LP ID (path parameter)