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

# List Email Senders

> Return every sender identity for the company. Combines locally-stored senders with senders discovered via integrated providers (SendGrid/Resend) — provider-discovered senders that aren't yet locally registered come back with `can_add=true`.



## OpenAPI

````yaml GET /email/senders/
openapi: 3.1.0
info:
  title: Outbox AI API
  description: API for managing AI agents (chatbots and voicebots) on the Outbox platform
  version: 1.0.0
servers:
  - url: https://api.getoutbox.ai
security: []
paths:
  /email/senders/:
    get:
      tags:
        - email
      summary: List Email Sender Identities
      description: >-
        Return every sender identity for the company. Combines locally-stored
        senders with senders discovered via integrated providers
        (SendGrid/Resend) — provider-discovered senders that aren't yet locally
        registered come back with `can_add=true`.
      operationId: email_senders_retrieve
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailSenderListResponse'
          description: ''
      security:
        - jwtAuth: []
        - {}
components:
  schemas:
    EmailSenderListResponse:
      type: object
      properties:
        results:
          type: array
          items:
            type: object
            additionalProperties: {}
          description: >-
            Senders. Local senders include `id`; provider-discovered senders
            without a local row have `id=null` and `can_add=true`.
        integration:
          type: boolean
          description: True when at least one of SendGrid/Resend is integrated.
        providers:
          type: object
          additionalProperties: {}
          description: 'Per-provider boolean flags: `sendgrid`, `resend`.'
        errors:
          type: object
          additionalProperties: {}
          description: Provider-keyed error messages from probing the provider API.
      required:
        - integration
        - providers
        - results
  securitySchemes:
    jwtAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````