bidCostSheets

Requires permission biddesk:cost_sheet:read.

Lists a bid's cost sheets, newest first, each with its lines. Unit costs, evidence and manual reasons are null without permission to view costs. Requires Bid Desk and permission to read cost sheets.

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 BidCostSheets($bidId: ID!) {
  bidCostSheets(bidId: $bidId) {
    id
    status
    approvedAt
    approvedBy
    bidId
    configurationId
    lines {
      id
      costCurrency
      description
      evidence
      fxRate
      kind
    }
  }
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "query BidCostSheets($bidId: ID!) {\n  bidCostSheets(bidId: $bidId) {\n    id\n    status\n    approvedAt\n    approvedBy\n    bidId\n    configurationId\n    lines {\n      id\n      costCurrency\n      description\n      evidence\n      fxRate\n      kind\n    }\n  }\n}",
  "variables": {
    "bidId": "id"
  }
}
EOF

Variables:

{
  "bidId": "id"
}

Response:

{
  "data": {
    "bidCostSheets": [
      {
        "id": "id",
        "status": "APPROVED",
        "approvedAt": "2025-01-15T00:00:00Z",
        "approvedBy": "id",
        "bidId": "id",
        "configurationId": "id",
        "lines": [
          {
            "id": "id",
            "costCurrency": "string",
            "description": "string",
            "evidence": {},
            "fxRate": "string",
            "kind": "COMMISSIONING"
          }
        ]
      }
    ]
  }
}

bidCostSheets(
  bidId: ID!
): [BidCostSheet!]!

Arguments

bidCostSheets.bidId ● ID! non-null scalar

The bid.

Type

BidCostSheet object

One cost sheet of a bid (v1, v2, …): the frozen configuration snapshot it costs, the cost model version it is costed against, and its lines. Totals are not computed here.