# List agents (/docs/api-reference/agents/listAgents) > Retrieve all agents for the authenticated user with pagination support. **GET** `/agents` Retrieve all agents for the authenticated user with pagination support. ```yaml operationId: listAgents parameters: - name: pageno in: query schema: type: integer default: 1 description: Page number for pagination. - name: pagesize in: query schema: type: integer default: 30 maximum: 150 description: Number of items per page (max 150). - name: name in: query schema: type: string description: Filter agents whose name matches this substring (case-insensitive). responses: '200': description: Paginated list of agents. content: application/json: schema: type: object properties: bots: type: array items: type: object description: An AI voice agent. properties: id: type: integer example: 158910 name: type: string example: Customer Support Agent bot_type: type: string example: prompt bot_call_type: type: string enum: - Incoming - Outgoing user_id: type: integer user_name: type: string organization_id: type: integer welcome_message: type: string is_welcome_message_dynamic: type: boolean is_welcome_message_interruption: type: boolean is_interruption_allowed: type: boolean interruption_min_words: type: integer status_of_building_flow: type: string example: Completed context_breakdown: type: array items: type: object properties: id: type: integer context_title: type: string context_body: type: string is_enabled: type: boolean is_auto_generated: type: boolean languages: type: array description: Resolved language records. Each entry is `{value, label}` from `bot.language`. items: type: object properties: value: type: integer label: type: string llm_service: type: string example: gpt-4o-mini llm_temperature: type: number timezone: type: string description: >- IANA timezone set on this agent. `false` when unset, in which case the account timezone applies. example: America/New_York llm_straming_enabled: type: boolean asr_service: type: string example: deepgram_stream asr_deepgram_model: type: string asr_deepgram_numerals: type: boolean asr_deepgram_punctuate: type: boolean asr_deepgram_smart_format: type: boolean asr_deepgram_diarize: type: boolean silence_timeout: type: integer voice_provider: type: string voice_external_id: type: string description: External voice ID from the provider. voice_name: type: string english_voice_accent: type: string eleven_lab_voice_public_owner_id: type: string nullable: true speech_speed: type: number enable_web_search: type: boolean web_search_engine: type: string background_noise_enabled: type: boolean background_noice_name: oneOf: - type: string - type: boolean background_audio_volume: type: number initial_ringing_sound_enabled: type: boolean voicemail_enabled: type: boolean description: >- Whether voicemail detection is on. To change it, send the nested `voicemail.enabled` field when creating or updating the agent. voicemail_message: type: string description: >- Message the agent leaves when voicemail is detected. To change it, send the nested `voicemail.message` field when creating or updating the agent. is_end_call_enabled: type: boolean end_call_condition: type: string end_call_message: type: string end_call_message_type: type: string end_call_message_prompt: type: string max_call_duration_in_sec: type: integer user_idle_threshold_sec: type: integer first_ideal_message: type: string second_ideal_message: type: string last_ideal_message: type: string is_first_ideal_message_dynamic: type: boolean is_second_ideal_message_dynamic: type: boolean is_transfer_enabled: type: boolean is_custom_api_transfer_enabled: type: boolean description: >- Allow custom API integrations to transfer live calls. When enabled and a custom API response includes "__omni_transfer_number", the call is transferred to that number immediately. Optional "__omni_transfer_message" sets what the caller hears during the handover. transfer_options: type: array items: type: object properties: number: type: string type: type: string enum: - static - dynamic backup_numbers: type: array items: type: string transfer_condition: type: string transfer_message: type: string post_call_config_ids: type: array description: >- Resolved post-call notification configs. One entry per email/webhook destination. items: type: object properties: id: type: integer delivery_method: type: string enum: - Email - Webhook destination: type: string description: Comma-separated recipients for Email; webhook url for Webhook. include_summary: type: boolean include_full_conversation: type: boolean include_sentiment: type: boolean include_extracted_info: type: boolean extracted_variables: type: array items: type: object properties: key: type: string description: type: string attach_file_ids: type: array description: IDs of knowledge-base files attached to this agent. items: type: integer integrations: type: array description: Connected integration records (HubSpot, Salesforce, Slack, etc.). items: type: object flow_data: oneOf: - type: object - type: boolean bot_action_name: oneOf: - type: string - type: boolean version_history_enabled: type: boolean description: Whether version history is turned on for this agent's organization. total_records: type: integer description: Total number of agents on the account. example: bots: - id: 6342 name: Customer Support Agent bot_type: prompt user_name: Demo User user_id: 1234 bot_action_name: false language: - English voice: cgSgspJ2msm6clMCkdW9 voice_provider: deepgram voice_external_id: aura-asteria-en eleven_lab_voice_public_owner_id: false english_voice_accent: en-IN voice_name: asteria llm_service: gpt-4.1-mini llm_straming_enabled: true allow_to_delete: true status_of_building_flow: Completed dynamic_variables: [] flow_data: false bot_call_type: Outgoing attach_file_ids: [] attach_file_access_description: false integration_ids: [] integrations: [] enable_web_search: false web_search_engine: false post_call_config_ids: - id: 13208 delivery_method: false destination: demo@example.com include_summary: true include_full_conversation: true include_sentiment: true include_extracted_info: true extracted_variables: - key: user_name description: Name of the lead being called - key: agent_name description: Name of the virtual agent - key: company_name description: Name of the real estate company slack_integration_id: false slack_channel_name: false slack_channel_id: false salesforce_integration_id: false salesforce_object_name: false hubspot_integration_id: false hubspot_object_name: false webhook_url: false payload_transformation_type: none payload_transformation_template: false strip_country_code: false google_sheets_integration_id: false google_sheets_spreadsheet_id: false google_sheets_spreadsheet_name: false google_sheets_worksheet_name: Sheet1 whatsapp_integration_id: false whatsapp_template_sid: false cloud_whatsapp_phone_number_id: false cloud_whatsapp_template_id: false cloud_whatsapp_template_variables: [] cloud_whatsapp_templates: [] workflow_id: false trigger_call_statuses: - completed - voicemail_detected is_end_call_enabled: true end_call_condition: >- End the call when the user says goodbye, thank you, or indicates they are done with the conversation end_call_message: Thank you for calling. Have a great day! Goodbye. end_call_message_type: prompt end_call_message_prompt: End the call politely in the same language user is speaking voicemail_enabled: false background_noice_name: false background_audio_volume: 0.2 background_noise_enabled: false initial_ringing_sound_enabled: false speech_speed: 1 organization_branch_ids: [] closed_organization_branch_ids: [] total_records: 61 ``` **Python SDK** ```python from omnidimension import Client client = Client(api_key) # List all agents with pagination response = client.agent.list(page=1, page_size=10) print(response) ``` **curl** ```bash curl -X GET "https://omnidim.io/api/v1/agents" \ -H "Authorization: Bearer $OMNIDIM_API_KEY" ```