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

# Listar números de teléfono conectados

> Listar números de teléfono conectados. Consulta los parámetros, el ejemplo y las respuestas disponibles para esta operación.



## OpenAPI

````yaml es/api-reference/meta/openapi.json GET /meta/phone-numbers
openapi: 3.1.0
info:
  title: API Wrapper de Meta de Eazybe
  version: 1.0.0
  description: >-
    Una superficie REST autenticada de Eazybe para la API de WhatsApp Business
    Cloud.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: >-
      Sustituye este marcador por el host de la API de Eazybe asignado a tu
      entorno.
security:
  - bearerAuth: []
tags:
  - name: Números de teléfono
    description: Descubre las WABA y los identificadores de números de teléfono conectados.
  - name: Mensajería
    description: Envía mensajes de WhatsApp y actualiza su estado.
  - name: Plantillas
    description: Administra las plantillas de mensajes de WhatsApp.
  - name: Archivos multimedia
    description: Sube, consulta y elimina archivos multimedia de WhatsApp.
  - name: Webhooks
    description: Administra las suscripciones de webhooks de una WABA.
  - name: Analíticas
    description: Consulta analíticas de mensajería, conversaciones, precios y plantillas.
  - name: Perfiles y configuración
    description: Administra perfiles empresariales y ajustes de números de teléfono.
  - name: Automatización
    description: Configura mensajes de bienvenida, preguntas iniciales y comandos.
  - name: Códigos QR
    description: Administra códigos QR de clic para chatear.
  - name: Flows
    description: Administra el ciclo de vida de WhatsApp Flows.
  - name: Administración de números
    description: Registra números, administra PIN y sincroniza datos de coexistencia.
  - name: Lista de bloqueados
    description: Consulta, bloquea y desbloquea usuarios de WhatsApp.
paths:
  /meta/phone-numbers:
    get:
      tags:
        - Números de teléfono
      summary: Listar números de teléfono conectados
      description: >-
        Listar números de teléfono conectados. Consulta los parámetros, el
        ejemplo y las respuestas disponibles para esta operación.
      operationId: getPhoneNumbers
      responses:
        '200':
          description: >-
            Phone numbers fetched (may include per-WABA failures)


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `400` | Token resolved to a user with no organization | Fix the
            user's org assignment |

            | `404` | No connected WABA account found for this organization |
            Complete WABA embedded signup |
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                  - data
                properties:
                  status:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    required:
                      - total_wabas
                      - successful
                      - failed
                      - accounts
                    properties:
                      total_wabas:
                        type: integer
                      successful:
                        type: integer
                      failed:
                        type: integer
                      accounts:
                        type: array
                        items:
                          type: object
                          required:
                            - waba_id
                            - status
                            - phone_numbers
                          properties:
                            waba_id:
                              type: string
                            status:
                              type: boolean
                            phone_numbers:
                              type: array
                              items:
                                type: object
                                required:
                                  - id
                                  - display_phone_number
                                  - verified_name
                                  - quality_rating
                                  - code_verification_status
                                  - status
                                properties:
                                  id:
                                    type: string
                                  display_phone_number:
                                    type: string
                                  verified_name:
                                    type: string
                                  quality_rating:
                                    type: string
                                  code_verification_status:
                                    type: string
                                  status:
                                    type: string
              example:
                status: true
                message: Meta phone numbers fetched successfully
                data:
                  total_wabas: 2
                  successful: 1
                  failed: 1
                  accounts:
                    - waba_id: '1029384756'
                      status: true
                      phone_numbers:
                        - id: '5647382910'
                          display_phone_number: +91 99000 00000
                          verified_name: Acme Support
                          quality_rating: GREEN
                          code_verification_status: VERIFIED
                          status: CONNECTED
                    - waba_id: '2938475610'
                      status: false
                      phone_numbers: []
                      error: 'Error validating access token: Session has expired.'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: >-
        Token bearer de Eazybe. El token identifica la organización y debe
        mantenerse en el servidor.

````