siteworksBookingAccountSearchByMpan

Get siteworks booking information for an account given an MPAN.

Deprecation

The 'siteworksBookingAccountSearchByMpan' field is deprecated.

Please use getOnSiteJobsAccountBySupplyPointExternalIdentifier instead.

- Marked as deprecated on 2026-07-20.
- Scheduled for removal on or after 2026-10-20.

Arguments

mpan : String!


            required

The MPAN to search for.

Returns

SiteworksBookingAccountType

An object holding information about an account and its associated users, properties and meter points, used for administering siteworks bookings.

Possible Errors

Allowed Viewers

Customer

Partner User

Third party

Query Complexity

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

query SiteworksBookingAccountSearchByMpan($mpan: String!) {
  siteworksBookingAccountSearchByMpan(mpan: $mpan) {
    accountType
    activeCampaigns {
      ...SiteworksCampaignTypeFragment
    }
    billingName
    brand
    canModifyPayments {
      ...CanModifyPaymentsTypeFragment
    }
    marketSupplyAgreements {
      ...AgreementConnectionFragment
    }
    number
    properties {
      ...SiteworksBookingPropertyTypeFragment
    }
    siteworksRequests {
      ...SiteworksRequestTypeFragment
    }
    smets2Interest
    status
    users {
      ...AccountUserTypeFragment
    }
  }
}

{
  "mpan": "popular-term-buy-language-radio"
}

{
  "data": {
    "siteworksBookingAccountSearchByMpan": {
      "accountType": "marriage-hotel-paper-look-chance",
      "activeCampaigns": [SiteworksCampaignType],
      "billingName": "party-reflect-cold-election-sea",
      "brand": "very-Mr-than-plant-special",
      "canModifyPayments": CanModifyPaymentsType,
      "marketSupplyAgreements": AgreementConnection,
      "number": "tree-small-perhaps-technology-bill",
      "properties": [SiteworksBookingPropertyType],
      "siteworksRequests": [SiteworksRequestType],
      "smets2Interest": "PRIORITY",
      "status": "PENDING",
      "users": [AccountUserType]
    }
  }
}