> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engrate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Accounting Point Observations

> List each statement that the market made about one accounting point.

Each statement gives one fact for a period of validity. The list is in order of `stated_at`, then in the order that the messages came in. Engrate applies the statements in this order to make the `master_data` of the accounting point.

Errors:

- `404`: your organization is not set up for market communication, or it has   no accounting point with this identifier.

- `422`: `id` is not a UUID.



## OpenAPI

````yaml /openapi.json get /market-access/v1alpha1/accounting-points/{id}/observations
openapi: 3.1.0
info:
  title: Engrate API
  version: 1.0.0
servers:
  - url: https://api.engrate.io
security:
  - apiKeyAuth: []
paths:
  /market-access/v1alpha1/accounting-points/{id}/observations:
    get:
      tags:
        - accounting-points
      summary: List Accounting Point Observations
      description: >-
        List each statement that the market made about one accounting point.


        Each statement gives one fact for a period of validity. The list is in
        order of `stated_at`, then in the order that the messages came in.
        Engrate applies the statements in this order to make the `master_data`
        of the accounting point.


        Errors:


        - `404`: your organization is not set up for market communication, or it
        has   no accounting point with this identifier.


        - `422`: `id` is not a UUID.
      operationId: >-
        list_accounting_point_observations_market_access_v1alpha1_accounting_points__id__observations_get
      parameters:
        - description: The Engrate identifier of the accounting point.
          in: path
          name: id
          required: true
          schema:
            description: The Engrate identifier of the accounting point.
            format: uuid
            title: Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObservationList'
          description: Successful Response
        '404':
          description: >-
            Your organization is not set up for market communication, or it has
            no accounting point with this identifier.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ObservationList:
      properties:
        items:
          description: >-
            The statements, in the order that Engrate applies them to the master
            data.
          items:
            discriminator:
              mapping:
                aggregation_responsibility: '#/components/schemas/ObservedAggregationResponsibility'
                balance_group: '#/components/schemas/ObservedBalanceGroup'
                connection_status: '#/components/schemas/ObservedConnectionStatus'
                control_area: '#/components/schemas/ObservedControlArea'
                estimated_annual_energy: '#/components/schemas/ObservedEstimatedAnnualEnergy'
                grid_operator: '#/components/schemas/ObservedGridOperator'
                market_dimension: '#/components/schemas/ObservedMarketDimension'
                metering_grid_area: '#/components/schemas/ObservedMeteringGridArea'
                settlement_method: '#/components/schemas/ObservedSettlementMethod'
                type: '#/components/schemas/ObservedAccountingPointType'
              propertyName: fact
            oneOf:
              - $ref: '#/components/schemas/ObservedBalanceGroup'
              - $ref: '#/components/schemas/ObservedMeteringGridArea'
              - $ref: '#/components/schemas/ObservedControlArea'
              - $ref: '#/components/schemas/ObservedConnectionStatus'
              - $ref: '#/components/schemas/ObservedAccountingPointType'
              - $ref: '#/components/schemas/ObservedGridOperator'
              - $ref: '#/components/schemas/ObservedMarketDimension'
              - $ref: '#/components/schemas/ObservedAggregationResponsibility'
              - $ref: '#/components/schemas/ObservedSettlementMethod'
              - $ref: '#/components/schemas/ObservedEstimatedAnnualEnergy'
          title: Items
          type: array
      required:
        - items
      title: ObservationList
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ObservedAggregationResponsibility:
      description: >-
        A statement of which operator aggregates the energy of the accounting
        point.
      properties:
        fact:
          const: aggregation_responsibility
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - $ref: '#/components/schemas/AggregatorRole'
            - type: 'null'
          description: >-
            The operator that aggregates the energy. Null when the market states
            none for the period.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedAggregationResponsibility
      type: object
    ObservedBalanceGroup:
      description: A statement of the balance group of the accounting point.
      properties:
        fact:
          const: balance_group
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The balance group. Null when the market states that there is none
            for the period.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedBalanceGroup
      type: object
    ObservedConnectionStatus:
      description: A statement of the connection status of the accounting point.
      properties:
        fact:
          const: connection_status
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          $ref: '#/components/schemas/ConnectionStatus'
          description: The connection status.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedConnectionStatus
      type: object
    ObservedControlArea:
      description: A statement of the control area of the accounting point.
      properties:
        fact:
          const: control_area
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The control area. Null when the market states that there is none for
            the period.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedControlArea
      type: object
    ObservedEstimatedAnnualEnergy:
      description: >-
        A statement of the energy that the grid operator expects the accounting
        point to consume or produce in one year.
      properties:
        direction:
          $ref: '#/components/schemas/EnergyDirection'
          description: The direction of energy flow that the estimate is for.
        fact:
          const: estimated_annual_energy
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value_kwh:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            The estimated energy for one year, in kWh. Null when the market
            states none for the direction and the period.
          title: Value Kwh
      required:
        - direction
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value_kwh
      title: ObservedEstimatedAnnualEnergy
      type: object
    ObservedGridOperator:
      description: A statement of the grid operator of the accounting point.
      properties:
        fact:
          const: grid_operator
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          $ref: '#/components/schemas/ExtraIdentifier'
          description: The grid operator.
          examples:
            - kind: de.bdew
              value: '9903123000007'
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedGridOperator
      type: object
    ObservedMarketDimension:
      description: A statement of one market dimension of the accounting point.
      properties:
        fact:
          const: market_dimension
          title: Fact
          type: string
        key:
          description: The key of the market dimension.
          title: Key
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The value. Null when the market states no value for the key for the
            period.
          title: Value
      required:
        - fact
        - key
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedMarketDimension
      type: object
    ObservedMeteringGridArea:
      description: A statement of the metering grid area of the accounting point.
      properties:
        fact:
          const: metering_grid_area
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The metering grid area. Null when the market states that there is
            none for the period.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedMeteringGridArea
      type: object
    ObservedSettlementMethod:
      description: A statement of the settlement method of the accounting point.
      properties:
        fact:
          const: settlement_method
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          anyOf:
            - $ref: '#/components/schemas/SettlementMethod'
            - type: 'null'
          description: >-
            The settlement method. Null when the market states none for the
            period.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedSettlementMethod
      type: object
    ObservedAccountingPointType:
      description: A statement of the accounting point type.
      properties:
        fact:
          const: type
          title: Fact
          type: string
        observed_at:
          description: The time at which Engrate received the message.
          format: date-time
          title: Observed At
          type: string
        stated_at:
          description: >-
            The time that the market gives in the message that carries the
            statement. Of two statements about one fact, the later one applies.
          format: date-time
          title: Stated At
          type: string
        valid_from:
          description: The first date that the statement applies to.
          format: date
          title: Valid From
          type: string
        valid_to:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last date that the statement applies to. Null when the statement
            has no end.
          title: Valid To
        value:
          $ref: '#/components/schemas/AccountingPointType'
          description: The accounting point type.
      required:
        - fact
        - observed_at
        - stated_at
        - valid_from
        - value
      title: ObservedAccountingPointType
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    AggregatorRole:
      description: >-
        ### Available aggregator roles


        - **grid_operator** — Indicates the source of the aggregation is a grid
        operator.


        - **transmission_operator** — Indicates the source of the aggregation is
        a transmission system operator.
      enum:
        - grid_operator
        - transmission_operator
      examples:
        - grid_operator
      title: AggregatorRole
      type: string
    ExtraIdentifier:
      description: >-
        A code that an external registry or authority gives to a party or an
        area, together with its kind.
      example:
        kind: eic
        value: 46X000000000245K
      properties:
        kind:
          $ref: '#/components/schemas/IdentifierKind'
          description: The kind of identifier
        value:
          description: The identifier value
          title: Value
          type: string
      required:
        - kind
        - value
      title: ExtraIdentifier
      type: object
    ConnectionStatus:
      description: |-
        The physical state of the connection of an accounting point.

        ### Available connection statuses

        - **new** — The accounting point is new and not connected yet.

        - **connected** — The accounting point is connected to the grid.

        - **disconnected** — The accounting point is disconnected from the grid.

        - **closed** — The grid operator closed the accounting point.
      enum:
        - new
        - connected
        - disconnected
        - closed
      examples:
        - new
      title: ConnectionStatus
      type: string
    EnergyDirection:
      description: |-
        The direction in which energy flows.

        ### Available energy directions

        - **consumption** — Energy that the accounting point consumes.

        - **production** — Energy that the accounting point produces.
      enum:
        - consumption
        - production
      examples:
        - consumption
      title: EnergyDirection
      type: string
    SettlementMethod:
      description: >-
        How the market settles the energy of an accounting point.


        ### Available settlement methods


        - **metered** — The market settles the accounting point from its metered
        values.


        - **profiled** — The market settles the accounting point from a profile.
      enum:
        - metered
        - profiled
      examples:
        - metered
      title: SettlementMethod
      type: string
    AccountingPointType:
      description: >-
        The direction or directions in which energy flows at an accounting
        point.


        ### Available accounting point types


        - **consumption** — The accounting point consumes energy.


        - **production** — The accounting point produces energy.


        - **combined** — The accounting point consumes and produces energy.
      enum:
        - consumption
        - production
        - combined
      examples:
        - consumption
      title: AccountingPointType
      type: string
    IdentifierKind:
      description: >-
        The scheme that issued an identifier.


        ### Available identifier kinds


        - **eic** — Energy Identification Code, issued under the ENTSO-E scheme.


        - **vat** — Value added tax registration number.


        - **gln** — Global Location Number, issued by GS1.


        - **de.bdew** — BDEW code number of a German market party.


        - **se.ediel** — Ediel ID of a Swedish market party.


        - **se.mga_code** — Code of a Swedish metering grid area, such as `ABB`.


        - **no.mga_code** — Code of a Norwegian metering grid area.


        - **nl.mga_code** — EAN-18 code of a Dutch metering grid area
        (netgebied).


        - **esett.mga_type** — Type of a metering grid area in the eSett
        imbalance settlement, such as `DISTRIBUTION`.
      enum:
        - eic
        - vat
        - gln
        - de.bdew
        - se.ediel
        - se.mga_code
        - no.mga_code
        - nl.mga_code
        - esett.mga_type
      examples:
        - eic
      title: IdentifierKind
      type: string
  securitySchemes:
    apiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.