openapi: 3.2.0
info:
  title: Red Electrica (e-sios) content Es API
  version: '2026-09-22'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-09-22: 3 operation(s) read from 3 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; archiveIdId has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 8
    pages-with-code: 40
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-09-22'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://api.esios.ree.es/doc/content/getting_a_list_of_documentations_with_media.html
  - https://api.esios.ree.es/doc/content/getting_a_specific_documentations.html
  - https://api.esios.ree.es/doc/content/getting_a_specific_static_pages_as_contents_url_part_by_id.html
  x-docs-section: content
security:
- apiKey: []
tags:
- name: Es
paths:
  /es/{eId}:
    get:
      operationId: get_es_eId
      tags:
      - Es
      summary: Getting a list of Documentations with media
      description: GET /es/documentations?taxonomy_terms[]=taxonomy_term_1&taxonomy_terms[]=taxonomy_term_2&vocabularies[]=vocabulary_1&vocabularies[]=vocabulary_2
      x-source: https://api.esios.ree.es/doc/content/getting_a_list_of_documentations_with_media.html
      parameters:
      - name: eId
        in: path
        required: true
        schema:
          type: string
      - name: locale
        in: query
        required: false
        schema:
          type: string
        description: 'Get translations for sources (es, en). Default language: es'
      - name: taxonomy_terms
        in: query
        required: false
        schema:
          type: string
        description: Taxonomy term associated with the Documentations
      - name: vocabularies
        in: query
        required: false
        schema:
          type: string
        description: Vocabularies associated with the Documentations
      - name: taxonomy_ids
        in: query
        required: false
        schema:
          type: string
        description: Taxonomy term associated with the Documentations by id
      - name: vocabulary_ids
        in: query
        required: false
        schema:
          type: string
        description: Vocabularies associated with the Documentations by id
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: Order Documentations by published, updated and created dates
      - name: sticky
        in: query
        required: false
        schema:
          type: string
        description: Filter Documentations by sticky option - true, false
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEsEidResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 6 example path(s) differing only at eId
  /es/{eId}/content-3:
    get:
      operationId: get_es_eId_content_3
      tags:
      - Es
      summary: Getting a specific Documentations
      description: Retrieves the documentation content identified by slug "content-3".
      x-source: https://api.esios.ree.es/doc/content/getting_a_specific_documentations.html
      parameters:
      - name: eId
        in: path
        required: true
        schema:
          type: string
      - name: locale
        in: query
        required: false
        schema:
          type: string
        description: 'Get translations for sources (es, en). Default language: es'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEsEidContent3Response'
      x-evidence:
        kind: documentation
        collapsed_from: 6 example path(s) differing only at eId
components:
  schemas:
    GetEsEidContent3Response:
      type: object
      properties:
        content:
          type: object
          description: Content object
        meta:
          type: object
          description: Metadata object
    GetEsEidResponse:
      type: object
      properties:
        contents:
          type: array
          description: Array of documentation objects
        meta:
          type: object
          description: Metadata about the response
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key