---
title: "AgentValidationRequest"
url: "https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e/schemas/AgentValidationRequest"
---

> Full API specification: https://developers.zinnia.com/apis/new-business/versions/b8532e16-b28e-4393-9305-def50b91e40e.md

# AgentValidationRequest

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business API.
  version: 0.9.8
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:
    Agent:
      type: object
      properties:
        firstName:
          type: string
          description: First Name of the party
          example: Thomas
        lastName:
          type: string
          description: Last Name of the the party
          example: Lawrence
        middleName:
          type: string
          description: Middle name of the party
        name:
          type: string
          description: Full name of the party.
          example: Thomas Lawrence
        externalId:
          type: string
          description: Agent External id
          example: PG000001
        agentDistributorChannel:
          type: string
          description: Agent Distribution Channel
          example: CAS
        licenseNumber:
          type: string
          description: Agent license Number
          example: "19584368"
        brokerName:
          type: string
          description: Name of broker firm
          example: ABC Company
        brokerExternalid:
          type: string
          description: Broker External Id
          example: "12324234"
        taxIdType:
          type: string
          enum:
            - P
            - C
          description: Type of Tax Id. P means Individual and C means Corporate
          example: P
        taxId:
          type: string
          description: Agent tax Id
          example: "123456789"
        npn:
          type: string
          description: NPN of the agent
          example: "1223435346"
        parentNpn:
          type: string
          description: Parent entity NPN number
          example: "1242353455"
        dateOfTrust:
          type: string
          format: date
          description: Date of trust
        parentTaxId:
          type: string
          description: Parent taxId
          example: "1242353455"
        type:
          type: string
          enum:
            - Agent
            - Primary Writing Agent
            - Additional Writing Agent
            - Primary Servicing Agent
            - Additional Servicing Agent
            - General Agent
        solicitingServiceIndicator:
          type: boolean
          description: if the agent is servicing agent send the flag as True else false
          example: true
        agentPercent:
          type: number
          description: Agent percent
          example: 100
        classification:
          type: string
          enum:
            - Individual
            - Business
            - Trust
            - Corporation
            - Partnership
            - Other
            - Group of Individuals
            - Estate
          description: Party classification
          example: Individual
      required:
        - classification
        - firstName
        - lastName
        - externalId
        - brokerName
        - licenseNumber
        - taxId
        - agentDistributorChannel
        - solicitingServiceIndicator
        - agentPercent
    AgentValidationRequest:
      type: object
      properties:
        carrier:
          type: string
          description: client code
        appStartDate:
          type: string
          description: Application start date
          example: 2024-02-07
        appState:
          type: string
          description: application state
          example: AL
        productCode:
          type: string
          description: product code
        agents:
          type: array
          items:
            $ref: "#/components/schemas/Agent"
      required:
        - carrier
        - appStartDate
        - appState
        - productCode
```