---
title: "PhoneV2"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/PhoneV2"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# PhoneV2

A phone record returned by V2 phone endpoints.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    PhoneType:
      title: PhoneType
      type: string
      description: The type of phone
      enum:
        - CELL
        - BUSINESS
        - RESIDENT
        - FAX
      example: CELL
    PhoneV2:
      title: PhoneV2
      type: object
      description: |
        A phone record returned by V2 phone endpoints.
      required:
        - id
        - type
        - number
        - preferred
        - createdAt
      properties:
        id:
          type: string
          format: uuid
          description: Phone identifier.
          readOnly: true
          example: 550e8400-e29b-41d4-a716-446655440000
        type:
          $ref: "#/components/schemas/PhoneType"
        number:
          type: string
          description: 10-digit phone number.
          example: "3035551234"
        extension:
          type: string
          nullable: true
          description: Optional phone extension.
          example: "1234"
        preferred:
          type: boolean
          description: Whether this is the preferred phone number.
          example: true
        createdAt:
          type: string
          format: date-time
          description: RFC3339 UTC timestamp when the phone was created.
          readOnly: true
          example: 2024-01-15T10:30:00Z
        updatedAt:
          type: string
          format: date-time
          nullable: true
          description: RFC3339 UTC timestamp when the phone was last updated.
          readOnly: true
          example: 2024-01-15T14:45:00Z
```