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

# List IVR Transfer References

> List IVR transfer references before publishing a new version of an agent that may receive IVR handoffs.

<span data-api-safety-label="read-only"><Badge color="gray" size="sm" shape="pill">Read only</Badge></span>

List IVR transfer references before publishing a new version of an agent that may receive IVR handoffs. The result identifies published IVR agents in your workspace whose live menus point to this agent.

## Before you begin

* Find the target agent ID through [List Agents](/docs/api-reference/v1/agents/list).
* Review the target draft before changing published behavior.

## List IVR Transfer References Request

```http theme={null}
GET /v1/agents/agent_abc123/ivr-transfer-references
```

## Verify the result

Read the `data` array in the `200` response. Each item contains an IVR agent `id` and `name`. An empty array means no matching published IVR reference was found. Draft-only menus are not included.

## Errors and recovery

`401` means the API key is missing or invalid. Confirm the ID and active workspace if the list is unexpectedly empty. This read does not publish anything and is safe to retry.

## Related endpoints

* [Update Agent](/docs/api-reference/v1/agents/update)
* [IVR publishing warnings](/docs/agents/ivr-agents#handoff-variables-and-publishing-warnings)


## OpenAPI

````yaml GET /v1/agents/{id}/ivr-transfer-references
openapi: 3.0.0
info:
  title: DialNexa API
  description: Public `/v1` REST API for the DialNexa voice AI platform.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: Agents
  - name: Batch Calls
  - name: Calls
  - name: Knowledge Base
  - name: Languages
  - name: LLMs
  - name: Phone Numbers
  - name: Transcribers
  - name: Webhooks
  - name: Voices
  - name: Workflows
  - name: Workflow Leads
  - name: Authentication
  - name: Agent Builder
paths:
  /v1/agents/{id}/ivr-transfer-references:
    get:
      tags:
        - Agents
      summary: List IVR Transfer References
      description: >-
        Returns published IVR agents in this workspace that transfer to the
        selected agent. Use before publishing a new target version to assess
        affected callers.
      operationId: listIvrTransferReferences
      parameters:
        - name: id
          in: path
          required: true
          schema:
            example: agent_2g7Xy3tY53gRlp
            type: string
          description: Agent ID from List Agents.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: boolean
                  statusCode:
                    type: integer
                  message:
                    type: string
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                          nullable: true
                      required:
                        - id
                        - name
                  timestamp:
                    type: string
                    format: date-time
                required:
                  - success
                  - error
                  - statusCode
                  - message
                  - data
                  - timestamp
              examples:
                success:
                  value:
                    success: true
                    error: false
                    statusCode: 200
                    message: Success
                    data:
                      - id: agent_abc123
                        name: Support
                    timestamp: '2026-09-07T06:00:00.000Z'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  value:
                    statusCode: 401
                    message: Missing or invalid API key.
                    error: Unauthorized
      security:
        - bearer: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: phone_number must be a valid E.164 phone number
        error:
          type: string
          example: Bad Request
      required:
        - statusCode
        - message
        - error
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````