> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Start Employee Verification Request

> Start a new employee verification request.



## OpenAPI

````yaml /api-reference/openapi.json post /employee_verification_requests
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /employee_verification_requests:
    post:
      tags:
        - Employee Verification
      summary: Start Employee Verification Request
      description: Start a new employee verification request.
      operationId: start_employee_verification_request_employee_verification_requests_post
      parameters:
        - name: Prefer
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Request execution preference (RFC 7240). Use ``respond-async`` for
              asynchronous execution, ``wait=N`` to specify a synchronous
              timeout hint in seconds, or ``priority=low`` to route the task to
              the low-priority queue.
            examples:
              - respond-async
              - wait=30
              - priority=low
            title: Prefer
          description: >-
            Request execution preference (RFC 7240). Use ``respond-async`` for
            asynchronous execution, ``wait=N`` to specify a synchronous timeout
            hint in seconds, or ``priority=low`` to route the task to the
            low-priority queue.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v1.EmployeeVerificationRequest'
              title: Employee Verification Request
              description: >-
                The request containing person and business details to verify
                employment.
              examples:
                - person_name: Jane Smith
                  business_name: Acme Corp
                  business_address: 123 Main St, Springfield, IL 62701
      responses:
        '201':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1.EmployeeVerificationRequestResponse'
            application/vnd.baselayer.v1+json:
              schema:
                $ref: '#/components/schemas/v1.EmployeeVerificationRequestResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    v1.EmployeeVerificationRequest:
      properties:
        person_name:
          type: string
          title: Person Name
          description: Full name of the person to verify.
        business_name:
          type: string
          title: Business Name
          description: Name of the business to check against.
        business_address:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Address
          description: Business address for disambiguation.
        alternative_names:
          anyOf:
            - items:
                type: string
              type: array
              maxItems: 10
              uniqueItems: true
            - type: 'null'
          title: Alternative Names
          description: Alternative names for the business (e.g., DBA names).
      additionalProperties: false
      type: object
      required:
        - person_name
        - business_name
      title: EmployeeVerificationRequest (v1)
    v1.EmployeeVerificationRequestResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: ID of the employee verification request.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: When the request was created.
        updated_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Updated At
          description: When the request was last updated.
        state:
          $ref: '#/components/schemas/TaskState'
          description: Current state of the request.
        person_name:
          type: string
          title: Person Name
          description: Full name of the person being verified.
        business_name:
          type: string
          title: Business Name
          description: Name of the business being checked.
        business_address:
          anyOf:
            - type: string
            - type: 'null'
          title: Business Address
          description: Business address provided for disambiguation.
        alternative_names:
          anyOf:
            - items:
                type: string
              type: array
              uniqueItems: true
            - type: 'null'
          title: Alternative Names
          description: Alternative names provided for the business.
        verified:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Verified
          description: Whether the person was verified as an employee.
        role_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Role Title
          description: Job title or role, if discovered.
        department:
          anyOf:
            - type: string
            - type: 'null'
          title: Department
          description: Department, if discovered.
        evidence_summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Evidence Summary
          description: Summary of evidence found.
        contact:
          anyOf:
            - $ref: '#/components/schemas/EmployeeVerificationContact'
            - type: 'null'
          description: Contact information discovered for the person.
        socials:
          anyOf:
            - items:
                $ref: '#/components/schemas/EmployeeVerificationSocial'
              type: array
            - type: 'null'
          title: Socials
          description: Social media profiles discovered for the person.
        miscellaneous_links:
          anyOf:
            - items:
                $ref: '#/components/schemas/EmployeeVerificationMiscLink'
              type: array
            - type: 'null'
          title: Miscellaneous Links
          description: Other web links found for the person (e.g. GitHub, personal site).
        sources:
          anyOf:
            - items:
                $ref: '#/components/schemas/EmployeeVerificationSource'
              type: array
            - type: 'null'
          title: Sources
          description: Sources consulted during verification.
      type: object
      required:
        - id
        - created_at
        - state
        - person_name
        - business_name
      title: EmployeeVerificationRequestResponse (v1)
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TaskState:
      enum:
        - PENDING
        - EXECUTING
        - COMPLETED
        - FAILED
        - CANCELLED
      title: TaskState
      type: string
    EmployeeVerificationContact:
      properties:
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
          description: Email address.
        phone:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone
          description: Phone number.
      type: object
      title: EmployeeVerificationContact
    EmployeeVerificationSocial:
      properties:
        platform:
          $ref: '#/components/schemas/SocialSite'
          description: Social media platform.
        url:
          type: string
          title: Url
          description: Profile URL.
      type: object
      required:
        - platform
        - url
      title: EmployeeVerificationSocial
    EmployeeVerificationMiscLink:
      properties:
        label:
          type: string
          title: Label
          description: Description of the link (e.g. 'GitHub profile', 'Personal website').
        url:
          type: string
          title: Url
          description: URL.
      type: object
      required:
        - label
        - url
      title: EmployeeVerificationMiscLink
    EmployeeVerificationSource:
      properties:
        url:
          type: string
          title: Url
          description: URL of the source.
        description:
          type: string
          title: Description
          description: What this source says about the person.
      type: object
      required:
        - url
        - description
      title: EmployeeVerificationSource
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    SocialSite:
      type: string
      enum:
        - linked_in:personal
        - linked_in:company
        - twitter
        - instagram
        - facebook
        - youtube
        - tiktok
        - pinterest
        - x
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````