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

# Get Whatsapp signup session status

> Retrieve the current state and status of a WhatsApp Embedded Signup session.



## OpenAPI

````yaml /openapi/source/external/legacy-published/whatsapp/management.json get /whatsapp/signup/{id}/status
openapi: 3.1.0
info:
  contact:
    email: support@telnyx.com
  description: >
    API for managing WhatsApp Business Accounts (WABAs), phone numbers, and
    message templates.


    Use these endpoints to:

    - List and manage WhatsApp Business Accounts

    - Configure phone numbers for WhatsApp

    - Create and manage message templates

    - Set up webhook configurations
  title: Telnyx WhatsApp Management API
  version: 2.0.0
servers:
  - url: https://api.telnyx.com/v2
security:
  - bearerAuth: []
paths:
  /whatsapp/signup/{id}/status:
    get:
      tags:
        - Whatsapp Signup
      summary: Get Whatsapp signup session status
      description: >-
        Retrieve the current state and status of a WhatsApp Embedded Signup
        session.
      operationId: GetWhatsappSignupSessionStatus
      parameters:
        - $ref: '#/components/parameters/WhatsappSignupSessionId'
      responses:
        '200':
          $ref: '#/components/responses/WhatsappSignupSessionResponse'
          description: Whatsapp signup session
        '404':
          description: Signup session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/messaging_Errors'
              example:
                errors:
                  - code: '10005'
                    title: Resource not found
                    detail: The requested resource or URL could not be found
        4XX:
          $ref: '#/components/responses/messaging_GenericErrorResponse'
components:
  parameters:
    WhatsappSignupSessionId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Signup session ID
  responses:
    WhatsappSignupSessionResponse:
      description: Successful response with a WhatsApp signup session
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/WhatsappSignupSession'
          example:
            data:
              record_type: whatsapp_session_id
              session_id: 019f4253-e09a-7622-bc6f-625378711d78
              user_id: 00000000-0000-4000-8000-000000000000
              state: SHARE_CREDIT_LINE
              status: FAILURE
              created_at: '2026-10-01T09:58:25Z'
              updated_at: '2026-10-01T09:58:27Z'
              waba_id: '123456789012345'
              customer_id: acme-corp-42
              errors:
                - >-
                  [ShareCreditLine] Bad status received: Invalid parameter
                  Credit Allocation Not Allowed During Month-End Close: This
                  WhatsApp Business Account cannot be moved onto a credit line
                  while the monthly billing close is running. Please try again
                  once the close has completed, usually within the first few
                  days of the month.
    messaging_GenericErrorResponse:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/messaging_Errors'
          example:
            errors:
              - code: string
                title: string
                detail: string
                source:
                  pointer: /data/attributes/phone_number
                  parameter: string
  schemas:
    messaging_Errors:
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/messaging_Error'
    WhatsappSignupSession:
      type: object
      properties:
        record_type:
          type: string
          enum:
            - whatsapp_session_id
        session_id:
          type: string
          description: Signup session ID
        user_id:
          type: string
          description: Telnyx user ID that owns the signup session
        state:
          type: string
          enum:
            - SUBSCRIBE_WEBHOOKS
            - ASSIGNED_USERS
            - SHARE_CREDIT_LINE
            - REGISTER_PHONE_NUMBER
            - ADD_WABA_TO_DB
            - ADD_PHONE_NUMBERS_TO_DB
            - COMPLETE
          description: >-
            Current provisioning step, or the step that failed.
            `REGISTER_PHONE_NUMBER` is skipped for coexistence signups.
        status:
          type: string
          enum:
            - INCOMPLETE
            - PENDING
            - SUCCESS
            - FAILURE
          description: >-
            `INCOMPLETE` waits for the Meta signup code, `PENDING` is in
            progress, `SUCCESS` finished provisioning, and `FAILURE` stopped at
            `state`.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        waba_id:
          type: string
          description: Meta WhatsApp Business Account ID
        customer_id:
          type: string
          description: Tech provider customer reference submitted with the signup
        errors:
          type: array
          items:
            type: string
          description: Errors recorded during provisioning
    messaging_Error:
      required:
        - code
        - title
      properties:
        code:
          type: string
          x-format: integer
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          properties:
            pointer:
              description: JSON pointer (RFC6901) to the offending entity.
              type: string
              format: json-pointer
            parameter:
              description: Indicates which query parameter caused the error.
              type: string
        meta:
          type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````