bidDeskInsights

Requires permission biddesk:bid:list.

Win rate, turnaround from opened to first proposal release, estimator load, loss reasons and bid/no-bid quality for a window of at most 400 days, each headline with the previous window of equal length. Counts bids limited to what your role may see: sales reps see their own records, admins see everything by default, and other staff see their team. A confidential bid counts only for people who may see it. Requires Bid Desk and permission to list bids.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

query BidDeskInsights($range: AnalyticsRangeInput!) {
  bidDeskInsights(range: $range) {
    bidsPerEstimatorMonth
    from
    previousBidsPerEstimatorMonth
    previousTurnaroundMedianDays
    previousWinRatePct
    scope
    bidNoBid {
      go
      goLost
      goOpen
      goWinRatePct
      goWon
      noBid
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidDeskInsights($range: AnalyticsRangeInput!) {\n  bidDeskInsights(range: $range) {\n    bidsPerEstimatorMonth\n    from\n    previousBidsPerEstimatorMonth\n    previousTurnaroundMedianDays\n    previousWinRatePct\n    scope\n    bidNoBid {\n      go\n      goLost\n      goOpen\n      goWinRatePct\n      goWon\n      noBid\n    }\n  }\n}",
  "variables": {
    "range": {
      "from": "2025-01-15T00:00:00Z",
      "to": "2025-01-15T00:00:00Z"
    }
  }
}
EOF

Variables:

{
  "range": {
    "from": "2025-01-15T00:00:00Z",
    "to": "2025-01-15T00:00:00Z"
  }
}

Response:

{
  "data": {
    "bidDeskInsights": {
      "bidsPerEstimatorMonth": 0,
      "from": "2025-01-15T00:00:00Z",
      "previousBidsPerEstimatorMonth": 0,
      "previousTurnaroundMedianDays": 0,
      "previousWinRatePct": 0,
      "scope": "ALL",
      "bidNoBid": {
        "go": 0,
        "goLost": 0,
        "goOpen": 0,
        "goWinRatePct": 0,
        "goWon": 0,
        "noBid": 0
      }
    }
  }
}

bidDeskInsights(
  range: AnalyticsRangeInput!
): BidDeskInsights!

Arguments

bidDeskInsights.range ● AnalyticsRangeInput! non-null input

The date range and, optionally, the visibility scope.

Type

BidDeskInsights object

How the bid desk is doing in a window, with the previous window of equal length for comparison.