---
title: "Resolve phone number"
method: POST
path: "/phone-numbers/resolve"
tags: ["Phone Numbers"]
---

# Resolve phone number

`POST /phone-numbers/resolve`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/phone-numbers/resolve`
- Auth: HTTP bearer

Resolves a phone number to its configured agent or workflow for the specified call type (inbound/outbound).

## Request body

- object
  - `phoneNumber` string, required
  - `callType` 'inboundCall' | 'outboundCall', required

## Response `200`

Resolved agent or workflow configuration

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` union, required
      - object
        - `type` 'workflow', required
        - `id` string, required
        - `name` string, required
        - `description` string
        - `version` string
        - `tags` string[]
        - `workspaceId` string, required
        - `canvasViewport` unknown
        - `nodePositions` unknown
        - `workflow` unknown
        - `createdAt` string, nullable, required
        - `updatedAt` string, nullable, required
        - `createdBy` string
        - `updatedBy` string
      - object
        - `type` 'agent', required
        - `id` string, required
        - `name` string, required
        - `config` object, required
          - `llm` object, required
            - `provider` string, required
            - `model` string, required
            - `systemPrompt` string
            - `firstMessage` string
            - `firstMessageMode` string
            - `disableInterruptionsDuringFirstMessage` boolean, required
            - `maxTokens` number
            - `temperature` number
            - `thinkingBudgetEnabled` boolean, required
            - `thinkingBudget` number, required
          - `tts` object, required
            - `provider` string, required
            - `model` string, required
            - `voiceId` string, required
            - `speed` number
            - `stability` number
            - `similarityBoost` number
            - `additionalSettings` unknown
          - `sst` object, required
            - `provider` string, required
            - `model` string, required
            - `language` string
            - `temperature` number
            - `punctuate` boolean
            - `diarize` boolean
            - `additionalSettings` unknown
          - `compliance` object, required
            - `pciDss` boolean, required
            - `mifidIi` boolean, required
            - `euAiAct` boolean, required
            - `soc2` boolean, required
        - `userId` string, required
        - `workspaceId` string, required
        - `createdAt` union, required
          - string, date-time
          - string

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `404`: Phone number not found or not configured
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)