Eclipse Foundation

Eclipse Foundation Mailing List API

REST API for Eclipse Foundation mailing list metadata and subscription records, authenticated against the auth.eclipse.org foundation realm.

Documentation GitHub OpenAPI

Operations 6

GET Mailing Lists

GET /available Available Mailing Lists

GET /{listName} Mailing List

GET /projects Projects Mailing Lists

GET /projects/available Available Projects Mailing Lists

GET /projects/{projectID} Project Mailing Lists

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/mailing-lists-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  version: 1.0.0
  title: Eclipse Foundation Mailing List API
  license:
    name: Eclipse Public License - 2.0
    url: https://www.eclipse.org/legal/epl-2.0/
servers:
- url: https://api.eclipse.org/foundation/mailing-list
  description: Production endpoint for the membership portal data
tags:
- name: Mailing Lists
  description: Definitions in relation to retrieval of mailing lists
paths:
  ? ''
  : parameters:
    - name: username
      in: query
      description: The user id
      required: true
      schema:
        type: string
    get:
      tags:
      - Mailing Lists
      summary: Mailing Lists
      description: Returns a list of organizations from the Eclipse API
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingLists'
        '404':
          description: Not found
        '500':
          description: Error while retrieving data
  /available:
    get:
      tags:
      - Mailing Lists
      summary: Available Mailing Lists
      description: Returns a list of mailing lists available for subscription
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingLists'
        '500':
          description: Error while retrieving data
  /{listName}:
    parameters:
    - name: listName
      in: path
      description: The name of the mailing list to retrieve
      required: true
      schema:
        type: string
    get:
      tags:
      - Mailing Lists
      summary: Mailing List
      description: Returns a list of organizations from the Eclipse API
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingLists'
        '404':
          description: Not found
        '500':
          description: Error while retrieving data
  /projects:
    get:
      tags:
      - Mailing Lists
      summary: Projects Mailing Lists
      description: Returns a list of mailing lists mapped to project IDs
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingListMapping'
        '500':
          description: Error while retrieving data
  /projects/available:
    get:
      tags:
      - Mailing Lists
      summary: Available Projects Mailing Lists
      description: Returns a list of mailing lists available for subscription mapped to project IDs
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingListMapping'
        '500':
          description: Error while retrieving data
  /projects/{projectID}:
    parameters:
    - name: projectID
      in: path
      description: The ID of the project to retrieve mailing lists for
      required: true
      schema:
        type: string
    get:
      tags:
      - Mailing Lists
      summary: Project Mailing Lists
      description: Returns a list of organizations from the Eclipse API
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MailingLists'
        '500':
          description: Error while retrieving data
components:
  securitySchemes:
    openId:
      type: openIdConnect
      openIdConnectUrl: https://auth.eclipse.org/auth/realms/foundation/.well-known/openid-configuration
  schemas:
    NullableString:
      description: A nullable String type value
      type:
      - 'null'
      - string
    DateTime:
      type: string
      format: datetime
      description: |
        Date string in the RFC 3339 format. Example, `1990-12-31T15:59:60-08:00`.

        More on this standard can be read at https://tools.ietf.org/html/rfc3339.
    MailingLists:
      type: array
      items:
        $ref: '#/components/schemas/MailingList'
    MailingList:
      type: object
      additionalProperties: false
      required:
      - list_name
      - project_id
      - create_archives
      - is_for_news_archives
      - is_deleted
      - is_disabled
      - is_private
      - is_subscribable
      properties:
        list_name:
          type: string
          description: Name of the mailing list
        list_description:
          $ref: '#/components/schemas/NullableString'
          description: Description of the purpose of the mailing list
        email:
          type: string
          description: The email address of the mailing list
        url:
          type: string
          description: Public URL containing records of communication on the mailing list
        project_id:
          type: string
          description: Project that the mailing list is associated with, if any
        list_short_description:
          $ref: '#/components/schemas/NullableString'
          description: placeholder
        create_archives:
          type: boolean
          description: placeholder
        is_for_news_archives:
          type: boolean
          description: placeholder
        is_deleted:
          type: boolean
          description: Whether the mailbox has been removed and this represents a historical list.
        is_disabled:
          type: boolean
          description: Whether the mailing list in question is currently active, or has been disabled from distributing messages
        is_private:
          type: boolean
          description: placeholder
        is_subscribable:
          type: boolean
          description: Whether users can currently subscribe to this mailing list
        create_date:
          $ref: '#/components/schemas/DateTime'
        created_by:
          $ref: '#/components/schemas/NullableString'
          description: placeholder
        provision_status:
          $ref: '#/components/schemas/NullableString'
          description: placeholder
        count:
          type:
          - 'null'
          - integer
          description: The number of subscribers for the given list. Only included on singular calls.
    MailingListMapping:
      type: object
      propertyNames:
        pattern: ^\d+$
        description: Project IDs the mailing lists are mapped to
      additionalProperties:
        $ref: '#/components/schemas/MailingLists'