> ## Documentation Index > Fetch the complete documentation index at: https://docs.coldsend.pro/llms.txt > Use this file to discover all available pages before exploring further. # List sender accounts > **List all sender email accounts in your workspace** Retrieve a paginated list of all configured sender accounts for sending emails. ## Filtering Options - **inbox_type**: Filter by inbox type (COLDSEND, GOOGLE_WORKSPACE, OUTLOOK_365, CUSTOM_SMTP) - **status**: Filter by status (ACTIVE, PAUSED, DISABLED) - **search**: Search by email address ## Sorting Options - **sort_by**: Field to sort by (email_address, inbox_type, created_at, health_score) - **sort_order**: Sort direction (asc, desc) ## Pagination - **page**: Page number (1-based) - **limit**: Items per page (1-100, default 20) ## OpenAPI ````yaml /public_openapi.json get /api/public/v1/sender-accounts openapi: 3.0.3 info: title: ColdSend Public API description: >- Programmatic access to ColdSend for managing cold email campaigns and sender accounts. version: 1.0.0 contact: name: ColdSend Support email: support@coldsend.pro url: https://coldsend.pro servers: - url: https://api.coldsend.pro description: Production security: - ApiKeyAuth: [] paths: /api/public/v1/sender-accounts: get: tags: - Sender Accounts summary: List sender accounts description: >- **List all sender email accounts in your workspace** Retrieve a paginated list of all configured sender accounts for sending emails. ## Filtering Options - **inbox_type**: Filter by inbox type (COLDSEND, GOOGLE_WORKSPACE, OUTLOOK_365, CUSTOM_SMTP) - **status**: Filter by status (ACTIVE, PAUSED, DISABLED) - **search**: Search by email address ## Sorting Options - **sort_by**: Field to sort by (email_address, inbox_type, created_at, health_score) - **sort_order**: Sort direction (asc, desc) ## Pagination - **page**: Page number (1-based) - **limit**: Items per page (1-100, default 20) operationId: list_sender_accounts_api_public_v1_sender_accounts_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 20 title: Limit description: Items per page - name: inbox_type in: query required: false schema: type: string nullable: true title: Inbox Type description: Filter by inbox type description: Filter by inbox type - name: status in: query required: false schema: type: string nullable: true title: Status description: Filter by status description: Filter by status - name: search in: query required: false schema: type: string nullable: true title: Search description: Search by email address description: Search by email address - name: sort_by in: query required: false schema: type: string nullable: true title: Sort By description: Sort field description: Sort field - name: sort_order in: query required: false schema: type: string nullable: true title: Sort Order description: Sort order (asc/desc) description: Sort order (asc/desc) responses: '200': description: Sender accounts retrieved successfully content: application/json: schema: $ref: '#/components/schemas/SenderAccountListResponse' '401': description: Missing or invalid API key '403': description: Insufficient permissions - requires 'sender_accounts:read' scope '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: SenderAccountListResponse: properties: success: type: boolean title: Success default: true message: type: string title: Message default: Sender accounts retrieved successfully sender_accounts: items: $ref: '#/components/schemas/SenderAccountListItem' type: array title: Sender Accounts description: List of sender accounts pagination: $ref: '#/components/schemas/PaginationMeta' description: Pagination information type: object required: - sender_accounts - pagination title: SenderAccountListResponse description: Response for listing sender accounts. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SenderAccountListItem: properties: inbox_id: type: string format: uuid title: Inbox Id description: Inbox ID email_address: type: string title: Email Address description: Email address display_name: type: string title: Display Name description: Display name inbox_type: type: string title: Inbox Type description: Inbox type (COLDSEND, GOOGLE_WORKSPACE, OUTLOOK_365, CUSTOM_SMTP) overall_status: type: string title: Overall Status description: Overall status (ACTIVE, PAUSED, DISABLED) daily_limit: type: integer title: Daily Limit description: Daily sending limit emails_sent_today: type: integer title: Emails Sent Today description: Emails sent today health_score: type: number title: Health Score description: Health score (0-100) created_at: type: string title: Created At description: Creation timestamp type: object required: - inbox_id - email_address - display_name - inbox_type - overall_status - daily_limit - emails_sent_today - health_score - created_at title: SenderAccountListItem description: Sender account list item schema. PaginationMeta: properties: page: type: integer title: Page limit: type: integer title: Limit total: type: integer title: Total pages: type: integer title: Pages has_next: type: boolean title: Has Next has_prev: type: boolean title: Has Prev type: object required: - page - limit - total - pages - has_next - has_prev title: PaginationMeta description: Pagination metadata schema. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key with format cs_live_xxx ````