bidDeskAccuracyInsights

Requires permission biddesk:bid:list.

How good cost estimates were for won bids closed in a window of at most 400 days whose actual costs have come back: the error per assembly over the matched parts with the share of the estimate that covers, the median error per bid, and the margin points made against the margin quoted. 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. Error figures are hidden without the cost view, margin points without the margin view. 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 BidDeskAccuracyInsights($range: AnalyticsRangeInput!) {
  bidDeskAccuracyInsights(range: $range) {
    bidsWithActuals
    from
    marginBidCount
    marginQuotedVsActualPts
    medianEstimateErrorPct
    previousMedianEstimateErrorPct
    assemblies {
      name
      bidCount
      coveragePct
      estimateErrorPct
      productId
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidDeskAccuracyInsights($range: AnalyticsRangeInput!) {\n  bidDeskAccuracyInsights(range: $range) {\n    bidsWithActuals\n    from\n    marginBidCount\n    marginQuotedVsActualPts\n    medianEstimateErrorPct\n    previousMedianEstimateErrorPct\n    assemblies {\n      name\n      bidCount\n      coveragePct\n      estimateErrorPct\n      productId\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": {
    "bidDeskAccuracyInsights": {
      "bidsWithActuals": 0,
      "from": "2025-01-15T00:00:00Z",
      "marginBidCount": 0,
      "marginQuotedVsActualPts": 0,
      "medianEstimateErrorPct": 0,
      "previousMedianEstimateErrorPct": 0,
      "assemblies": [
        {
          "name": "string",
          "bidCount": 0,
          "coveragePct": 0,
          "estimateErrorPct": 0,
          "productId": "id"
        }
      ]
    }
  }
}

bidDeskAccuracyInsights(
  range: AnalyticsRangeInput!
): BidDeskAccuracyInsights!

Arguments

bidDeskAccuracyInsights.range ● AnalyticsRangeInput! non-null input

The date range and, optionally, the visibility scope.

Type

BidDeskAccuracyInsights object

How good the bid desk's cost estimates were for won bids closed in the window whose actual costs have come back, and the margin made against the margin quoted.