---
title: "PhoneNumber"
url: "https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7/schemas/PhoneNumber"
---

> Full API specification: https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7.md

# PhoneNumber

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business Annuity API
  version: 0.7.0
servers:
  - url: https://qa.api.zinnia.io
    description: QA Environment
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://uat.api.zinnia.io
    description: UAT Environment
  - url: https://api.zinnia.io
    description: PROD Environment
components:
  schemas:
    PhoneNumber:
      type: object
      additionalProperties: false
      required:
        - phoneId
        - type
        - areaCode
        - dialNumber
      properties:
        phoneId:
          type: string
          description: Unique identifier for the phone number record.
          format: uuid
        type:
          type: string
          description: Type or classification of the phone number.
          enum:
            - BEEPERNUMBER
            - MOBILE
            - FACSIMILE
            - HOME
            - TELEPHONE
            - WORKPHONENUMBER
            - BUSINESS
            - FAX
            - UNKNOWN
            - CLAIMCENTER
            - CUSTOMERSERVICE
            - CORPORATEOFFICE
        countryCode:
          type: string
          description: Country dialing code for the phone number.
        areaCode:
          type: string
          description: Area code associated with the phone number.
        dialNumber:
          type: string
          description: Primary phone number excluding country and area codes.
        extension:
          type: string
          description: Phone extension, if applicable.
        bestTime:
          type: string
          description: Preferred time to contact using this phone number.
        timezone:
          type: string
          description: Time zone associated with the phone number location.
        zip:
          type: string
          description: ZIP code associated with the phone number.
        zipSuffix:
          type: string
          description: ZIP+4 suffix associated with the phone number, if applicable.
```