EmailRep

EmailRep Lists API

The Lists API from EmailRep — 4 operation(s) for lists.

GitHub OpenAPI

Operations 10

GET /v0/lists Retrieve lists #
POST /v0/lists Create list #
DELETE /v0/lists/{id} Delete list #
GET /v0/lists/{id} Get list #
PATCH /v0/lists/{id} Patch list #
GET /v0/lists/{id}/entries Get list entries #
PUT /v0/lists/{id}/entries Set list entries #
DELETE /v0/lists/{id}/entries/entry Delete list entry #
GET /v0/lists/{id}/entries/entry Get list entry #
POST /v0/lists/{id}/entries/entry Add list entry #

Documentation

📖
Documentation
https://docs.sublime.security/reference/emailrep-introduction
📖
APIReference
https://docs.sublime.security/reference/emailrep-introduction
📖
GettingStarted
https://github.com/sublime-security/emailrep.io#simple-usage

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/emailrep/refs/heads/main/openapi/emailrep-lists-api-openapi.yml

Other Resources

🔗
SDKs
https://github.com/sublime-security/emailrep.io-python
🔗
SDKs
https://pypi.org/project/emailrep/
🔗
SDKs
https://github.com/arnydo/PSEmailRep
🔗
SDKs
https://git.rud.is/hrbrmstr/emailrep
🔗
SDKs
https://github.com/WestDiscGolf/EmailRep.NET
🔗
SDKs
https://github.com/kaiiyer/emailrep
🔗
SDKs
https://github.com/vertoforce/go-emailrep
🔗
CLI
https://github.com/sublime-security/emailrep.io-python
🔗
SourceCode
https://github.com/sublime-security/emailrep.io

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/emailrep:emailrep-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

emailrep-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Sublime Platform Lists API
  version: generated
servers:
- url: '{scheme}://{server}'
  variables:
    scheme:
      default: https
      enum:
      - http
      - https
    server:
      default: platform.sublime.security
      description: Base URL of your Sublime deployment
security:
- bearerAuth: []
tags:
- name: Lists
paths:
  /v0/lists:
    get:
      description: Retrieve filtered lists
      operationId: getLists
      parameters:
      - description: List type to filter by. One of 'string', 'user_group', 'provider_org_unit'.
        in: query
        name: entry_type
        required: true
        schema:
          description: List type to filter by. One of 'string', 'user_group', 'provider_org_unit'.
          enum:
          - string
          - user_group
          - provider_org_unit
          type: string
      - description: Optional ID (exact match) to filter by
        in: query
        name: id
        schema:
          description: Optional ID (exact match) to filter by
          format: uuid
          type: string
      - description: Optional name (exact match) to filter by
        in: query
        name: name
        schema:
          description: Optional name (exact match) to filter by
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handler_typesGetListResponse'
          description: OK
      summary: Retrieve lists
      tags:
      - Lists
    post:
      description: Create a list
      operationId: createList
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateListInput'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handler_typesList'
          description: OK
      summary: Create list
      tags:
      - Lists
  /v0/lists/{id}:
    delete:
      description: Delete a list
      operationId: deleteList
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      responses:
        '200':
          description: OK
      summary: Delete list
      tags:
      - Lists
    get:
      description: Get a list
      operationId: getList
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handler_typesList'
          description: OK
      summary: Get list
      tags:
      - Lists
    patch:
      description: Patch a list
      operationId: patchList
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchListInput'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handler_typesList'
          description: OK
      summary: Patch list
      tags:
      - Lists
  /v0/lists/{id}/entries:
    get:
      description: Get all list entries
      operationId: getListEntries
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Handler_typesListEntries'
          description: OK
      summary: Get list entries
      tags:
      - Lists
    put:
      description: Set (overwrite) all list entries
      operationId: setListEntries
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetListEntriesInput'
      responses:
        '200':
          description: OK
      summary: Set list entries
      tags:
      - Lists
  /v0/lists/{id}/entries/entry:
    delete:
      description: Delete list entry, if present
      operationId: deleteListEntry
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      - description: String list entry
        in: query
        name: string
        required: true
        schema:
          description: String list entry
          maxLength: 2000
          type: string
      responses:
        '200':
          description: OK
      summary: Delete list entry
      tags:
      - Lists
    get:
      description: Get list entry, if present
      operationId: getListEntry
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      - description: String list entry
        in: query
        name: string
        required: true
        schema:
          description: String list entry
          maxLength: 2000
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: string
          description: OK
      summary: Get list entry
      tags:
      - Lists
    post:
      description: Add list entry, if not already present
      operationId: addListEntry
      parameters:
      - description: List ID
        in: path
        name: id
        required: true
        schema:
          description: List ID
          format: uuid
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddListEntryInput'
      responses:
        '200':
          description: OK
      summary: Add list entry
      tags:
      - Lists
components:
  schemas:
    Handler_typesList:
      properties:
        created_at:
          description: List creation time
          format: date-time
          type: string
        description:
          description: Description of list
          type: string
        editable:
          description: If the list may be edited. False for system lists.
          type: boolean
        entry_type:
          description: Type of entry. Supported values are 'string', 'user_group', 'provider_org_unit'
          type: string
        id:
          description: List ID
          format: uuid
          type: string
        name:
          description: Unique name used to reference the list in MQL
          type: string
        updated_at:
          description: List last updated time
          format: date-time
          type: string
      required:
      - description
      - id
      - name
      type: object
    PatchListInput:
      properties:
        description:
          description: Description of list
          type: string
      required:
      - description
      type: object
    Handler_typesListEntries:
      properties:
        entries:
          description: List of string entries
          items:
            type: string
          type: array
        overrides:
          description: List of override string entries
          items:
            type: string
          type: array
      type: object
    AddListEntryInput:
      properties:
        string:
          description: String list entry
          maxLength: 2000
          type: string
      type: object
    CreateListInput:
      properties:
        description:
          description: Description of list
          type: string
        name:
          description: Unique name used to reference the list in MQL
          type: string
      required:
      - description
      - name
      type: object
    SetListEntriesInput:
      properties:
        entries:
          description: List entries
          items:
            type: string
          type: array
      required:
      - entries
      type: object
    Handler_typesGetListResponse:
      properties:
        lists:
          description: List of lists
          items:
            $ref: '#/components/schemas/Handler_typesList'
          type: array
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
x-readme:
  explorer-enabled: false
x-provenance:
  method: harvested
  publisher: EmailRep
  source: https://docs.sublime.security/openapi/sublime-platform-api.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)