> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inprocess.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Emails

> Retrieve email addresses for artists on the In•Process protocol.

**Authentication required.**

Endpoint behavior depends on the type of API key used:
- **Normal API key**: No parameters accepted. The artist address is inferred from the API key and returns that artist's own email.
- **Admin API key**: `artist_address` is optional. If provided, returns the email for that specific artist. If omitted, returns a paginated list of all artist emails.



## OpenAPI

````yaml GET /emails
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /emails:
    get:
      summary: Get Emails
      description: >-
        Retrieve email addresses for artists on the In•Process protocol.


        **Authentication required.**


        Endpoint behavior depends on the type of API key used:

        - **Normal API key**: No parameters accepted. The artist address is
        inferred from the API key and returns that artist's own email.

        - **Admin API key**: `artist_address` is optional. If provided, returns
        the email for that specific artist. If omitted, returns a paginated list
        of all artist emails.
      operationId: getEmails
      parameters:
        - name: artist_address
          in: query
          description: >-
            The artist wallet address to look up the email for. **Admin API key
            only.** When provided, returns a single email object for that
            artist; when omitted, returns all emails paginated.
          required: false
          schema:
            type: string
        - name: cursor
          in: query
          description: >-
            Pagination cursor for fetching the next page of results. Use the
            `next_cursor` value from the previous response.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of email records to return per page.
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 100
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: >-
                      Single artist email response (normal API key, or admin API
                      key with artist_address provided)
                    properties:
                      email:
                        type: string
                        nullable: true
                        description: >-
                          The email address associated with the artist, or null
                          if not found
                  - type: object
                    description: >-
                      Paginated list of artist emails (admin API key only, no
                      artist_address provided)
                    properties:
                      emails:
                        type: array
                        description: Array of artist email records
                        items:
                          type: object
                          properties:
                            address:
                              type: string
                              description: >-
                                The social wallet address associated with the
                                email
                            email:
                              type: string
                              description: The artist's email address
                            artist_address:
                              type: string
                              nullable: true
                              description: >-
                                The artist's primary wallet address, or null if
                                not mapped
                            username:
                              type: string
                              nullable: true
                              description: The artist's username, or null if not set
                      next_cursor:
                        type: string
                        nullable: true
                        description: >-
                          Cursor for the next page of results. Null if there are
                          no more pages.
              examples:
                single_artist:
                  summary: Single artist email
                  value:
                    email: artist@example.com
                paginated_list:
                  summary: Paginated email list (admin)
                  value:
                    emails:
                      - address: 0xabc123...
                        email: artist@example.com
                        artist_address: 0xdef456...
                        username: sweetman.eth
                    next_cursor: cursor_token_here
        '403':
          description: >-
            Forbidden - the artist does not have the required API key type for
            the requested operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: error
                message: Forbidden
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Error status
        message:
          type: string
          description: Error message
        errors:
          type: array
          description: >-
            Optional array of field-level validation errors. Typically included
            in 400 Bad Request responses for validation errors.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                description: The field name that failed validation
              message:
                type: string
                description: The validation error message for this field
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Artist API key for authentication. Get your API key from
        https://inprocess.world/manage/api-keys

````