> ## Documentation Index > Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt > Use this file to discover all available pages before exploring further. # Get one Phone Agent call > One call the Phone Agent handled, by its `call_id`, with the same fields as `GET /phone/calls`. Use it to follow a call while it runs: while `state` is `LIVE` or `WRAPPING_UP`, `transcription` and `tool_calls` are written every few seconds, so polling every 5 seconds sees each change. 404 `phone_call_not_found` for a call id this tenant does not have. ## OpenAPI ````yaml https://api.neoagent.io/public-api/openapi.json get /public-api/phone/calls/{call_id} openapi: 3.1.0 info: description: >- Neo's public contract for the dashboard ChatAgent, partner integrations, and MSP automation. Every response is wrapped in a `{data, meta}` envelope; errors use `{error: {code, message, details?}, meta: {request_id}}`. Authenticate with a `Bearer neo_sk__` API key (service account) or a Microsoft Entra ID JWT (dashboard user). Signed-URL endpoints (end-user feedback links) take a `signature` query parameter instead. title: Neo Public API version: 1.0.0 servers: - url: https://api.neoagent.io security: [] tags: - description: Service metadata — health, OpenAPI. name: Meta - description: Agents and workflows — read, version history, delete, stats. name: Agents - description: Agent/workflow execution history, sub-resources, retry/cancel. name: Executions - description: >- Every tool call the tenant's agents made in the last 30 days, within the caller's workflow access. name: Audit Log - description: PSA webhook events and their workflow-match results. name: Callbacks - description: Technician-in-the-loop approval requests. name: TIL requests - description: RMM script executions triggered by agents. name: RMM scripts - description: Dispatch-agent field-update decisions. name: Dispatch - description: The authenticated tenant. name: Tenant - description: Agent-builder schema catalogs (raw JSON payloads). name: Schemas - description: Escalate to the Neo team (HubSpot ticket). name: Escalation - description: Tenant settings. name: Settings - description: Tenant API-key management (dashboard JWT only). name: API keys - description: End-user feedback links (signed-URL auth). name: Feedback - description: End-client companies (CRUD + bulk-update). name: End companies - description: Channels — bind a CONVERSATIONAL agent to a transport (Teams or Slack). name: Channels - description: PSA/RMM/M365 integration status and connection management. name: Integrations - description: Technician roster (controls TIL routing and paging). name: Technicians - description: Future runs queued for TRIGGERED agents. name: Scheduled work - description: Subscription state and customer-facing credit usage (no provider $). name: Billing - description: Inbox messages and announcements. name: Inbox & Comms - description: Tenant-authored agent skills (CRUD) and the built-in skill catalog. name: Skills paths: /public-api/phone/calls/{call_id}: get: tags: - Phone Agent summary: Get one Phone Agent call description: >- One call the Phone Agent handled, by its `call_id`, with the same fields as `GET /phone/calls`. Use it to follow a call while it runs: while `state` is `LIVE` or `WRAPPING_UP`, `transcription` and `tool_calls` are written every few seconds, so polling every 5 seconds sees each change. 404 `phone_call_not_found` for a call id this tenant does not have. operationId: public_api.phone_call_get parameters: - in: path name: call_id required: true schema: type: string responses: '200': content: application/json: schema: properties: data: $ref: '#/components/schemas/PublicPhoneCall' meta: $ref: '#/components/schemas/SuccessMeta' required: - data - meta type: object description: Success. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Bad request — malformed input. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Unauthenticated — missing or invalid credentials. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Forbidden — authenticated but not allowed. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Not found. '409': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Conflict — the resource is in a state that blocks this operation. '422': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Request validation failed. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limited — see Retry-After. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. security: - bearerAuth: [] components: schemas: PublicPhoneCall: description: >- Public projection of a `phone_calls` row. No recording URL or binary content here — those are kept in the dashboard surface so retention/PII rules can be enforced uniformly. properties: call_id: anyOf: - type: string - type: 'null' description: >- The call's own id, for `GET /phone/calls/{call_id}`; null on calls from before April 2025. title: Call Id created_at: format: date-time title: Created At type: string duration_seconds: anyOf: - type: number - type: 'null' title: Duration Seconds finished_at: anyOf: - format: date-time type: string - type: 'null' title: Finished At from_number: title: From Number type: string id: title: Id type: integer sentiment: anyOf: - $ref: '#/components/schemas/Sentiment' - type: 'null' description: >- How the phone agent handled the call: `POSITIVE` (it handled the request to an end), `NEUTRAL` (the caller made no request, the call ended mid-request, or false "I can't hear you" prompts made it harder), `NEGATIVE` (its handling failed the caller), or `NO_REQUEST` (the caller said nothing to the agent). Null until Neo rates the call, a minute or two after it ends. state: description: >- `LIVE` while the caller is on the line, `WRAPPING_UP` after the hang-up while Neo writes the transcript, the ticket and the recording (a minute or two), then `ENDED`. A new value is additive. enum: - LIVE - WRAPPING_UP - ENDED title: State type: string tickets: anyOf: - items: $ref: '#/components/schemas/PublicPhoneCallTicket' type: array - type: 'null' title: Tickets to_number: title: To Number type: string tool_calls: anyOf: - items: $ref: '#/components/schemas/PublicPhoneCallToolCall' type: array - type: 'null' title: Tool Calls transcription: anyOf: - type: string - type: 'null' description: >- The call's transcript as `User:` / `Assistant:` lines. While the call is `LIVE` or `WRAPPING_UP` it is the transcript so far, updated every few seconds; the final one replaces it when the call ends. title: Transcription transferred_at: anyOf: - format: date-time type: string - type: 'null' title: Transferred At transferred_to: anyOf: - type: string - type: 'null' title: Transferred To required: - id - call_id - state - from_number - to_number - duration_seconds - transcription - sentiment - created_at - finished_at - transferred_to - transferred_at - tickets - tool_calls title: PublicPhoneCall type: object SuccessMeta: properties: pagination: $ref: '#/components/schemas/Pagination' request_id: format: uuid type: string timings_ms: additionalProperties: type: number type: object warnings: description: >- Non-fatal warnings about the created/updated resource (e.g. an unhealthy PSA callback). items: type: string type: array required: - request_id - timings_ms type: object ErrorEnvelope: properties: error: properties: code: description: Stable machine-readable error code. type: string details: additionalProperties: true type: object message: type: string required: - code - message type: object meta: properties: request_id: format: uuid type: - string - 'null' type: object required: - error - meta type: object Sentiment: description: >- A call's rating, as stored and shown. NO_REQUEST is a call where the caller said nothing to the agent; Neo sets it without an LLM call, so no LLM is offered it (`AssessedSentiment`). enum: - POSITIVE - NEGATIVE - NEUTRAL - NO_REQUEST title: Sentiment type: string PublicPhoneCallTicket: description: >- Public projection of one ticket a call created. Its own model, so an internal change to `PhoneCallTicket` cannot reach partner serialization or the OpenAPI document without a public API review. `relation` is one of `CREATED_IN_CALL` (the agent's tool, caller on the line) or `CREATED_POST_CALL` (the post-call fallback); a new value is additive. properties: reference: title: Reference type: string relation: title: Relation type: string ticket_id: title: Ticket Id type: string url: anyOf: - type: string - type: 'null' title: Url required: - ticket_id - reference - url - relation title: PublicPhoneCallTicket type: object PublicPhoneCallToolCall: description: >- Public projection of one tool the agent ran on a call. Its own model for the same reason as `PublicPhoneCallTicket`. properties: arguments: additionalProperties: true description: >- What the agent passed to the tool. Each text value is cut at 500 characters. title: Arguments type: object finished_at: anyOf: - format: date-time type: string - type: 'null' title: Finished At name: description: >- The tool, for example `create_ticket`, `find_tickets`, `verify_company` or `transfer_call`. A new tool name is additive. title: Name type: string started_at: format: date-time title: Started At type: string status: description: >- `RUNNING` while the tool runs, then `SUCCEEDED`, `FAILED` (it raised an error) or `CANCELLED` (the caller spoke over the agent and the tool was stopped). `NOT_FINISHED`: the call is over and no end was recorded. A tool that refused (for example an unidentified caller) answers with its reason and `SUCCEEDED`. A new value is additive. enum: - RUNNING - SUCCEEDED - FAILED - CANCELLED - NOT_FINISHED title: Status type: string tool_call_id: title: Tool Call Id type: string transcript_messages_before: description: >- How many `User:` / `Assistant:` messages of `transcription` came before the tool started; 0 is before the first message. While the tool runs the count can still grow by one. title: Transcript Messages Before type: integer transfer_outcome: anyOf: - enum: - HANDED_OFF_BLIND - ANSWERED - DECLINED - VOICEMAIL - ANSWERED_THEN_ENDED - NO_ANSWER - CALLER_HUNG_UP - NOT_CONNECTED - NOT_PLACED type: string - type: 'null' description: >- Set only on a `transfer_call` or `warm_transfer_call` that ended: what happened to the caller, which `status` does not say (a transfer that reached nobody still ends `SUCCEEDED`). `HANDED_OFF_BLIND`: the phone system took the caller, and the agent did not hear who answered. `ANSWERED`: a person answered, was briefed and took the caller. `DECLINED`: a person answered and did not take the caller. `VOICEMAIL`: voicemail or an automated menu answered. `ANSWERED_THEN_ENDED`: answered, then ended before the caller was put through. `NO_ANSWER`: nobody answered. `CALLER_HUNG_UP`: the caller hung up before they were put through. `NOT_CONNECTED`: the transfer did not go through. `NOT_PLACED`: the agent did not dial the number. Null on every other tool, on a transfer that is still running, failed or was stopped without a result, and on calls from before November 2026. A new value is additive. title: Transfer Outcome required: - tool_call_id - name - arguments - status - started_at - finished_at - transcript_messages_before - transfer_outcome title: PublicPhoneCallToolCall type: object Pagination: properties: has_more: type: boolean next_cursor: type: - string - 'null' required: - next_cursor - has_more type: object securitySchemes: bearerAuth: description: >- `Authorization: Bearer ` where `` is either a `neo_sk__` API key (service account) or a Microsoft Entra ID access token (dashboard user). scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.