> ## 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 Aggregation Objects > List registered aggregation objects. Returns aggregation objects registered via UTILMD messages for energy settlement purposes. BRP is automatically filtered via org_uid. Args: tso: Optional TSO Y area code filter (e.g., 10YDE-EON------1) sender: Optional sender MP-ID filter (DSO) - returns MGAs managed by this DSO aggregation_object: Optional specific object ID filter aggregation_type: Optional type filter (BAS, SLP, RLM) aggregation_subtype: Optional OBIS code filter month: Optional month for validity check (YYYY-MM) Returns: List of matching aggregation objects ## OpenAPI ````yaml /openapi.json get /schedule-management/v1/mabis/aggregation-objects openapi: 3.1.0 info: title: Engrate API version: 1.0.0 servers: - url: https://api.engrate.io security: - apiKeyAuth: [] paths: /schedule-management/v1/mabis/aggregation-objects: get: tags: - mabis summary: List Aggregation Objects description: >- List registered aggregation objects. Returns aggregation objects registered via UTILMD messages for energy settlement purposes. BRP is automatically filtered via org_uid. Args: tso: Optional TSO Y area code filter (e.g., 10YDE-EON------1) sender: Optional sender MP-ID filter (DSO) - returns MGAs managed by this DSO aggregation_object: Optional specific object ID filter aggregation_type: Optional type filter (BAS, SLP, RLM) aggregation_subtype: Optional OBIS code filter month: Optional month for validity check (YYYY-MM) Returns: List of matching aggregation objects operationId: >- list_aggregation_objects_schedule_management_v1_mabis_aggregation_objects_get parameters: - description: TSO Y area code filter (e.g., 10YDE-EON------1) in: query name: tso_area required: false schema: anyOf: - type: string - type: 'null' description: TSO Y area code filter (e.g., 10YDE-EON------1) title: Tso Area - description: Sender MP-ID filter (DSO) - returns MGAs managed by this DSO in: query name: sender required: false schema: anyOf: - type: string - type: 'null' description: Sender MP-ID filter (DSO) - returns MGAs managed by this DSO title: Sender - description: Aggregation object ID filter in: query name: aggregation_object required: false schema: anyOf: - type: string - type: 'null' description: Aggregation object ID filter title: Aggregation Object - description: >- Aggregation type filter. 'BAS': Bilanzierungssummenzeitreihe (balance summary), 'FPE': Fahrplanersatz (schedule replacement), 'FPI': Fahrplanimpuls (schedule impulse), 'SLP': Standard load profile, 'RLM': Registrierende Leistungsmessung (smart meter). in: query name: aggregation_type required: false schema: anyOf: - type: string - type: 'null' description: >- Aggregation type filter. 'BAS': Bilanzierungssummenzeitreihe (balance summary), 'FPE': Fahrplanersatz (schedule replacement), 'FPI': Fahrplanimpuls (schedule impulse), 'SLP': Standard load profile, 'RLM': Registrierende Leistungsmessung (smart meter). title: Aggregation Type - description: Subtype/OBIS code filter in: query name: aggregation_subtype required: false schema: anyOf: - type: string - type: 'null' description: Subtype/OBIS code filter title: Aggregation Subtype - description: Month for validity filter (YYYY-MM) in: query name: month required: false schema: anyOf: - type: string - type: 'null' description: Month for validity filter (YYYY-MM) title: Month responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/AggregationObjectResponse' title: >- Response List Aggregation Objects Schedule Management V1 Mabis Aggregation Objects Get type: array description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error components: schemas: AggregationObjectResponse: description: Response model for aggregation objects. properties: aggregation_subtypes: description: OBIS codes items: type: string title: Aggregation Subtypes type: array aggregation_type: description: 'Type: BAS, FPE, FPI, SLP, RLM' title: Aggregation Type type: string brp: anyOf: - type: string - type: 'null' description: Balance responsible party EIC title: Brp date_from: description: Valid from date (YYYY-MM-DD) title: Date From type: string date_to: anyOf: - type: string - type: 'null' description: Valid to date (YYYY-MM-DD) title: Date To dso: description: Distribution system operator identifier title: Dso type: string id: description: Aggregation object identifier (MaBiS-ZP ID) title: Id type: string mga: anyOf: - type: string - type: 'null' description: MGA Y area code (Marktgebietsverantwortlicher) title: Mga receiver: anyOf: - type: integer - type: 'null' description: Receiver MP-ID title: Receiver sender: anyOf: - type: integer - type: 'null' description: Sender MP-ID (DSO responsible for this MGA) title: Sender status: description: 'Status: pending, confirmed, rejected, deactivated' title: Status type: string time_series_type: anyOf: - type: string - type: 'null' description: Summenzeitreihe type (Z95-ZG7, e.g., ZA6=ASZR) title: Time Series Type tso: description: TSO Y area code (e.g., 10YDE-EON------1) title: Tso type: string required: - aggregation_type - date_from - dso - id - status - tso title: AggregationObjectResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError 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 securitySchemes: apiKeyAuth: in: header name: Authorization type: apiKey ````