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

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

# PersonV2

Customer-facing producer identity. SSN is masked — only the last four digits are present via `ssnLast4`. The full unmasked SSN is available only via `GET /v2/persons/{personId}/ssn`.

## 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:
    PersonTitle:
      type: string
      nullable: true
      enum:
        - DR
        - MR
        - MRS
        - MS
        - MISS
      description: The person's honorific title.
      example: MS
    PersonSuffix:
      type: string
      nullable: true
      enum:
        - JR
        - SR
        - I
        - II
        - III
        - OBE
        - MBE
        - BSC
        - JP
        - GM
      description: The person's name suffix.
      example: JR
    PersonGender:
      type: string
      nullable: true
      enum:
        - MALE
        - FEMALE
      description: The person's gender.
      example: FEMALE
    PersonV2:
      title: PersonV2
      description: >
        Customer-facing producer identity. SSN is masked — only the last four
        digits are present via `ssnLast4`. The full unmasked SSN is available
        only via `GET /v2/persons/{personId}/ssn`.
      type: object
      required:
        - id
        - npnVerified
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier of the person.
          readOnly: true
          example: 550e8400-e29b-41d4-a716-446655440000
        title:
          $ref: "#/components/schemas/PersonTitle"
        firstName:
          type: string
          description: The person's first name.
          example: Jane
        preferredFirstName:
          type: string
          nullable: true
          description: The name the person prefers to be addressed by, when different from
            their legal first name.
          example: Janey
        middleName:
          type: string
          nullable: true
          description: The person's middle name.
          example: Quincy
        lastName:
          type: string
          description: The person's last name.
          example: Smith
        suffix:
          $ref: "#/components/schemas/PersonSuffix"
        primaryEmail:
          type: string
          format: email
          nullable: true
          description: The person's primary contact email address.
          example: jane.smith@example.com
        secondaryEmail:
          type: string
          format: email
          nullable: true
          description: The person's secondary contact email address.
          example: jane.alt@example.com
        dateOfBirth:
          type: string
          format: date
          nullable: true
          description: The person's date of birth (YYYY-MM-DD).
          example: 1990-05-15
        gender:
          $ref: "#/components/schemas/PersonGender"
        citizenshipCountry:
          type: string
          nullable: true
          description: The person's country of citizenship.
          example: US
        residentState:
          type: string
          nullable: true
          description: The person's state of residence.
          example: CO
        unitedStatesCitizen:
          type: boolean
          nullable: true
          description: Whether the person is a United States citizen.
          example: true
        unitedStatesWorkAuthorized:
          type: boolean
          nullable: true
          description: Whether the person is authorized to work in the United States.
          example: true
        married:
          type: boolean
          nullable: true
          description: Whether the person is married.
          example: false
        npn:
          type: string
          nullable: true
          description: National Producer Number.
          example: "12345678"
        npnVerified:
          type: boolean
          readOnly: true
          description: Whether the person's NPN has been verified against NIPR.
        finraCrdNumber:
          type: string
          nullable: true
          description: The person's FINRA Central Registration Depository (CRD) number.
          example: "1234567"
        ssnLast4:
          type: string
          nullable: true
          description: Last four digits of the Social Security Number. Full SSN available
            only via GET /v2/persons/{personId}/ssn.
          example: "6789"
        createdAt:
          type: string
          format: date-time
          description: RFC3339 timestamp when the person record was created.
          readOnly: true
          example: 2026-01-15T10:30:00Z
        updatedAt:
          type: string
          format: date-time
          description: RFC3339 timestamp of the most recent modification.
          readOnly: true
          example: 2026-06-01T14:22:00Z
```