---
updatedAt: 2025-09-11T23:48:31.000Z
agentTools:
  projectIndex: https://developer.getbright.se/llms.txt
---

# Integration Steps

An ordered overview of the integration steps.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th style={{ textAlign: "left" }}>
        Endpoint
      </th>

      <th style={{ textAlign: "left" }}>
        Benefit
      </th>

      <th style={{ textAlign: "left" }}>
        Notes
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td style={{ textAlign: "left" }}>
        [bankId](https://developer.getbright.se/reference/bankid)
        or
        [openId](https://developer.getbright.se/reference/openid)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables a <Glossary>User</Glossary> to verify their identity and login to the app.
      </td>

      <td style={{ textAlign: "left" }}>
        This step is needed to confirm the identity of the person or company attempting to login and establish a scope for the data they can view.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [oauth](https://developer.getbright.se/reference/oauth) or API Key
      </td>

      <td style={{ textAlign: "left" }}>
        Enables access to the entire<Glossary>Data Layer</Glossary>.
      </td>

      <td style={{ textAlign: "left" }}>
        Any of the supported authorization flows that result in a type of `access_token` for subsequent api calls is acceptable. Refresh tokens must be able to be used outside of <Glossary>User</Glossary> interactions.  

        API Key is the easiest to manage and recommended for <Glossary>Organisation</Glossary>s who support its use.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Search for account](https://developer.getbright.se/reference/post-accounts-search)
      </td>

      <td style={{ textAlign: "left" }}>
        Fetch the `accountId`
      </td>

      <td style={{ textAlign: "left" }}>
        Use the `personalNumber` as the `ssn` from a BankId authorization flow after a `completed` status value shows up from [BankId collect](https://developer.getbright.se/reference/post-bankid-collect).  

        Use the `email` after a successful [oauth](https://developer.getbright.se/reference/oauth) or [openId](https://developer.getbright.se/reference/openid) flow.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get account](https://developer.getbright.se/reference/get-account)
      </td>

      <td style={{ textAlign: "left" }}>
        Populates data in the <Glossary>User</Glossary> profile view.
      </td>

      <td style={{ textAlign: "left" }}>
        Confirms the `accountId`is correctly attributed to the <Glossary>User</Glossary>.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get user roles for account](https://developer.getbright.se/reference/get-account-user-roles)
      </td>

      <td style={{ textAlign: "left" }}>
        Enable user management within an <Glossary>Account</Glossary>. 
      </td>

      <td style={{ textAlign: "left" }}>
        <Glossary>Account Owner</Glossary>s can manage <Glossary>Guest</Glossary>s and other <Glossary>Account Owner</Glossary>s.
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get locations](https://developer.getbright.se/reference/get-locations-for-account)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Service</Glossary>s provided by the <Glossary>Organisation</Glossary> to be viewed by the <Glossary>Account Owner</Glossary>.  

        Enables <Glossary>Location</Glossary> data to viewed by <Glossary>User</Glossary>s. 
      </td>

      <td style={{ textAlign: "left" }}>

      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get agreements](https://developer.getbright.se/reference/get-agreements)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Agreement</Glossary>s for a single <Glossary>Service</Glossary> to be viewed by the <Glossary>Account Owner</Glossary>.
      </td>

      <td style={{ textAlign: "left" }}>

      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get account invoices](https://developer.getbright.se/reference/get-account-invoices)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Invoice</Glossary> data for all <Glossary>Service</Glossary>s to be viewed by the <Glossary>Account Owner</Glossary>.
      </td>

      <td style={{ textAlign: "left" }}>

      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get measurements for service](https://developer.getbright.se/reference/get-service-measurements)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Measurements</Glossary> viewing by <Glossary>User</Glossary>s. 
      </td>

      <td style={{ textAlign: "left" }}>
        Inside each object in the services array from [Get locations](https://developer.getbright.se/reference/get-locations-for-account)    there is a `measurementId` for each <Glossary>Service</Glossary> used in requesting [Get measurements for service](https://developer.getbright.se/reference/get-service-measurements). 
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get products](https://developer.getbright.se/reference/getproducts)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Product</Glossary>s for each <Glossary>Service</Glossary> to be viewed by <Glossary>Account Owner</Glossary>s. 
      </td>

      <td style={{ textAlign: "left" }}>
        Inside each object in the services array from [Get locations](https://developer.getbright.se/reference/get-locations-for-account)   there is an `id` for each <Glossary>Service</Glossary> used as the `serviceId`in requesting [Get products](https://developer.getbright.se/reference/get-products).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get cost for a service](https://developer.getbright.se/reference/get-service-cost)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables the <Glossary>Cost</Glossary> for each <Glossary>Service</Glossary> to be viewed by <Glossary>Account</Glossary>s.
      </td>

      <td style={{ textAlign: "left" }}>
        Inside each object in the services array from [Get locations](https://developer.getbright.se/reference/get-locations-for-account)    there is a `costId` for each <Glossary>Service</Glossary> used in requesting [Get cost for a service](https://developer.getbright.se/reference/get-service-cost). 
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Get account invoice url](https://developer.getbright.se/reference/get-account-invoice-url) or [Get account invoice stream](https://developer.getbright.se/reference/get-account-invoice-stream)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables <Glossary>Invoice</Glossary> PDF's to be viewed by the <Glossary>Account Owner</Glossary>.
      </td>

      <td style={{ textAlign: "left" }}>
        Use a `invoiceId` from the response [Get account invoices](https://developer.getbright.se/reference/get-account-invoices).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Update user](https://developer.getbright.se/reference/update-user)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables a <Glossary>User</Glossary> to update their `phoneNumber`and `emailAddress`via the app.
      </td>

      <td style={{ textAlign: "left" }}>
        Inside each object in the response from [Get user roles for account](https://developer.getbright.se/reference/get-account-user-roles) there is a `user` object with an `id`used as the `userId`in requesting [Update user](https://developer.getbright.se/reference/update-user).
      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Add User to account](https://developer.getbright.se/reference/add-user-to-account)
      </td>

      <td style={{ textAlign: "left" }}>
        Enables an <Glossary>Account Owner</Glossary>to add new <Glossary>Guest</Glossary>s to their account.
      </td>

      <td style={{ textAlign: "left" }}>

      </td>
    </tr>

    <tr>
      <td style={{ textAlign: "left" }}>
        [Report Event](https://developer.getbright.se/reference/report-event)
      </td>

      <td style={{ textAlign: "left" }}>
        Allows Bright Energy to report <Glossary>Event</Glossary>s back to the <Glossary>Organisation</Glossary>.
      </td>

      <td style={{ textAlign: "left" }}>
        Use [Search for account](https://developer.getbright.se/reference/post-accounts-search) to get the `accountId` used in requesting [Report Event](https://developer.getbright.se/reference/report-event).
      </td>
    </tr>
  </tbody>
</Table>