> ## 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 Points

> List the accounting points of your organization, in the order of their market identifiers.

Every filter you give must match. Engrate reads the master data as of today on the calendar of the market. The listing does not include `aggregate_allocations`: read one accounting point for them.

Errors:

- `404`: your organization is not set up for market communication. Contact   Engrate.

- `422`: a filter is not valid. For example, `id` is not a UUID.



## OpenAPI

````yaml /openapi.json get /market-access/v1alpha1/accounting-points
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:
    get:
      tags:
        - accounting-points
      summary: List Accounting Points
      description: >-
        List the accounting points of your organization, in the order of their
        market identifiers.


        Every filter you give must match. Engrate reads the master data as of
        today on the calendar of the market. The listing does not include
        `aggregate_allocations`: read one accounting point for them.


        Errors:


        - `404`: your organization is not set up for market communication.
        Contact   Engrate.


        - `422`: a filter is not valid. For example, `id` is not a UUID.
      operationId: list_accounting_points_market_access_v1alpha1_accounting_points_get
      parameters:
        - description: Only the accounting point with this identifier.
          in: query
          name: id
          required: false
          schema:
            anyOf:
              - format: uuid
                type: string
              - type: 'null'
            description: Only the accounting point with this identifier.
            title: Id
        - description: Only accounting points in this market.
          in: query
          name: market
          required: false
          schema:
            anyOf:
              - const: DE
                type: string
              - type: 'null'
            description: Only accounting points in this market.
            title: Market
        - description: >-
            Only the accounting point with this market identifier. In Germany,
            the MaLo-ID.
          in: query
          name: market_identifier
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Only the accounting point with this market identifier. In Germany,
              the MaLo-ID.
            examples:
              - '26611699793'
            title: Market Identifier
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountingPointList'
          description: Successful Response
        '404':
          description: >-
            Your organization is not set up for market communication. Contact
            Engrate.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    AccountingPointList:
      properties:
        items:
          description: The accounting points that match the filters.
          items:
            $ref: '#/components/schemas/AccountingPoint'
          title: Items
          type: array
      required:
        - items
      title: AccountingPointList
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AccountingPoint:
      description: >-
        An accounting point of your organization: the point in the grid where
        supply can change from one supplier to another.
      properties:
        aggregate_allocations:
          anyOf:
            - items:
                $ref: '#/components/schemas/AggregateAllocationsPeriod'
              type: array
            - type: 'null'
          description: >-
            The aggregate allocations that hold this accounting point, split
            into the periods over which they do not change. Null in a listing,
            which does not read them.
          title: Aggregate Allocations
        id:
          description: The Engrate identifier of the accounting point.
          format: uuid
          title: Id
          type: string
        market:
          const: DE
          description: The market of the accounting point.
          title: Market
          type: string
        market_identifier:
          description: >-
            The identifier that the market gives to the accounting point. In
            Germany, the 11-digit market location ID (MaLo-ID).
          examples:
            - '26611699793'
          title: Market Identifier
          type: string
        master_data:
          $ref: '#/components/schemas/MasterData'
        supply_periods:
          description: The periods in which you supply the accounting point, oldest first.
          items:
            $ref: '#/components/schemas/SupplyPeriod'
          title: Supply Periods
          type: array
      required:
        - id
        - market
        - market_identifier
        - master_data
        - supply_periods
      title: AccountingPoint
      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
    AggregateAllocationsPeriod:
      description: >-
        A set of Aggregate Allocations this Accounting Point was part of in the
        given period.
      properties:
        aggregate_allocations:
          description: >-
            The aggregate allocations that include the accounting point in the
            period.
          items:
            $ref: '#/components/schemas/AggregateAllocation'
          title: Aggregate Allocations
          type: array
        end:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: The last date of the period, or null while open.
          title: End
        start:
          description: The first date of the period.
          format: date
          title: Start
          type: string
      required:
        - aggregate_allocations
        - start
      title: AggregateAllocationsPeriod
      type: object
    MasterData:
      description: >-
        The master data of the accounting point for one date, as Engrate knew it
        at one time.
      properties:
        as_of:
          description: The date that the facts apply to.
          format: date
          title: As Of
          type: string
        facts:
          $ref: '#/components/schemas/MasterDataFacts'
        known_at:
          description: >-
            The time at which Engrate read the facts. The facts include only the
            market messages that Engrate had received at this time. In UTC.
          format: date-time
          title: Known At
          type: string
      required:
        - as_of
        - facts
        - known_at
      title: MasterData
      type: object
    SupplyPeriod:
      description: >-
        A period in which you supply the accounting point. An accepted supplier
        switch opens it on its effective date.
      properties:
        end:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          description: >-
            The last day of the period. Null while the period has no end: no
            later supply period follows it, and the market states no end.
          title: End
        start:
          description: The first day of the period.
          format: date
          title: Start
          type: string
      required:
        - start
      title: SupplyPeriod
      type: object
    AggregateAllocation:
      description: >-
        An aggregate allocation and its aggregation dimensions. A null or absent
        dimension includes the accounting points of all values.
      properties:
        aggregator:
          $ref: '#/components/schemas/AggregatorRole'
        allocation_basis:
          $ref: '#/components/schemas/AllocationBasis'
        area_code:
          examples:
            - 10YDE-RWENET---I
            - '871664139537672423'
          title: Area Code
          type: string
        area_kind:
          $ref: '#/components/schemas/AreaKind'
        balance_group:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The balance group of the accounting points in the aggregate
            allocation. If the value is null, the aggregate allocation includes
            all balance groups.
          examples:
            - 11XBILANZKREIS-X
            - '8716867111118'
            - null
          title: Balance Group
        external_id:
          description: >-
            A stable identifier for the aggregate allocations. In most markets
            this is a unique identifier assigned by that market, but in markets
            that don't provide a stable identity (like NL), it's assigned by
            Engrate
          title: External Id
          type: string
        flow_direction:
          enum:
            - consumption
            - production
          title: Flow Direction
          type: string
        market_dimensions:
          additionalProperties:
            type: string
          description: >-
            Market-specific additional dimensions, used in markets that
            sub-divide aggregate allocations beyond what the common dimensions
            can represent. See [Market dimensions and metadata in each
            market](/market-communication/allocations/aggregate-allocations#market-dimensions-and-metadata-in-each-market)
            for the keys of each market.
          examples:
            - series_type: SLS
            - allocation_group: PRF
              offtake_type: AMI
              profile_category: E1A
          title: Market Dimensions
          type: object
        market_meta:
          additionalProperties:
            type: string
          description: >-
            Market-specific additional metadata, for instance in markets where
            datasets with the exact same dimensions are sent at different
            cadences (daily, monthly), this metadata tells them apart. See
            [Market dimensions and metadata in each
            market](/market-communication/allocations/aggregate-allocations#market-dimensions-and-metadata-in-each-market)
            for the keys of each market.
          examples:
            - control_area: 10YDE-RWENET---I
              summed_series: Z97
          title: Market Meta
          type: object
        supplier:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The supplier of the accounting points in the aggregate allocation.
            If the value is null, the aggregate allocation includes all
            suppliers.
          examples:
            - '9900000000001'
            - '8737940265429'
            - null
          title: Supplier
      required:
        - aggregator
        - allocation_basis
        - area_code
        - area_kind
        - balance_group
        - external_id
        - flow_direction
        - market_dimensions
        - market_meta
        - supplier
      title: AggregateAllocation
      type: object
    MasterDataFacts:
      description: What the market states about the accounting point for one date.
      properties:
        aggregation_responsibility:
          anyOf:
            - $ref: '#/components/schemas/AggregatorRole'
            - type: 'null'
          description: >-
            Which operator aggregates the energy of the accounting point. Null
            when the market states no value for the date.
        balance_group:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The balance group that the accounting point is supplied in. Null
            when the market states no value for the date.
        connection_status:
          anyOf:
            - $ref: '#/components/schemas/ConnectionStatus'
            - type: 'null'
          description: >-
            The physical state of the connection, as the grid operator states
            it. Null when the market states no value for the date.
        control_area:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The control area that the metering grid area is in. In Germany, the
            control areas are also the scheduling areas. Null when the market
            states no value for the date.
        estimated_annual_consumption_kwh:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            The energy, in kWh, that the grid operator expects the accounting
            point to consume in one year. Null when the market states no value
            for the date.
          title: Estimated Annual Consumption Kwh
        estimated_annual_production_kwh:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            The energy, in kWh, that the grid operator expects the accounting
            point to produce in one year. Null when the market states no value
            for the date.
          title: Estimated Annual Production Kwh
        grid_operator:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The grid operator that the accounting point connects to. Null when
            the market states no value for the date.
          examples:
            - kind: de.bdew
              value: '9903123000007'
        market_dimensions:
          additionalProperties:
            type: string
          description: >-
            Other values that the market states, with the keys and values of the
            market. They are the same market dimensions that aggregate
            allocations carry.
          title: Market Dimensions
          type: object
        metering_grid_area:
          anyOf:
            - $ref: '#/components/schemas/ExtraIdentifier'
            - type: 'null'
          description: >-
            The metering grid area in which the energy of the accounting point
            is settled. Null when the market states no value for the date.
        settlement_method:
          anyOf:
            - $ref: '#/components/schemas/SettlementMethod'
            - type: 'null'
          description: >-
            How the market settles the energy of the accounting point. Null when
            the market states no value for the date.
        type:
          anyOf:
            - $ref: '#/components/schemas/AccountingPointType'
            - type: 'null'
          description: >-
            The direction or directions in which energy flows at the accounting
            point. Null when the market states no value for the date.
      title: MasterDataFacts
      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
    AllocationBasis:
      description: >-
        The basis tells you where the energy data for an aggregation is coming
        from: Is it directly metered values from smart meters, or is it
        something calculated from some standard profile?


        ### Available allocation bases


        - **metered** — Indicates this aggregation's data comes from directly
        metered energy, like from smart meters.


        - **profiled** — Indicates this aggregation's data is coming from a
        'profile' of some kind, a pre-determined shape of consumption or
        production, usually coupled with some adjustment calculations, like
        adjusting for daily temperature or past annual metered consumption.
      enum:
        - metered
        - profiled
      examples:
        - metered
      title: AllocationBasis
      type: string
    AreaKind:
      description: >-
        ### Available area kinds


        - **metering_grid_area** — The area of one grid operator.


        - **control_area** — The area of one transmission system operator.


        - **scheduling_area** — See [Scheduling
        Area](/api-reference/core/models/scheduling-area).
      enum:
        - metering_grid_area
        - control_area
        - scheduling_area
      examples:
        - metering_grid_area
      title: AreaKind
      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
    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.