v1

latestOpenAPI 3.1.02026-07-222392081.7 MB
Quotes

Get quote valuation

Compute valuation metrics for an existing quote.

get/v1/quotes/{id}/valuation

Path parameters

idstring required

Query parameters

granularity'year' | 'quarter' | 'month'

Period granularity for the breakdown. When provided, contract value and recurring contract value include a by_period array.

Example:year

Period granularity for the breakdown. When provided, contract value and recurring contract value include a by_period array.

Response

Example response

{
  "contract_value": {
    "total": 120000,
    "invoiced": 30000,
    "remaining": 90000,
    "by_phase": [
      {
        "phase_id": "subpha_abc123",
        "phase_name": "Standard",
        "phase_type": "standard",
        "starts_at": "2025-01-01T00:00:00.000Z",
        "ends_at": "2025-12-31T23:59:59.999Z",
        "amount": 120000
      }
    ],
    "by_period": [
      {
        "period": "2025",
        "starts_at": "2025-01-01T00:00:00.000Z",
        "ends_at": "2025-12-31T23:59:59.999Z",
        "amount": 120000
      }
    ]
  },
  "recurring_contract_value": {
    "total": 100000,
    "by_phase": [
      {
        "phase_id": "subpha_abc123",
        "phase_name": "Standard",
        "starts_at": "2025-01-01T00:00:00.000Z",
        "ends_at": "2025-12-31T23:59:59.999Z",
        "annual_value": 100000,
        "phase_amount": 100000
      }
    ],
    "by_period": [
      {
        "period": "2025",
        "starts_at": "2025-01-01T00:00:00.000Z",
        "ends_at": "2025-12-31T23:59:59.999Z",
        "amount": 120000
      }
    ]
  },
  "arr": {
    "fixed": 100000,
    "variable": {
      "current": 5000,
      "averaged": 4500
    }
  }
}