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

# Resolve Employee Aliases

> Accepts a list of employee aliases (e.g. SSNs) and returns their corresponding UUIDs.



## OpenAPI

````yaml POST /v1/employer-identifiers/{employer_identifier}/employee-aliases/resolve
openapi: 3.1.0
info:
  title: Payroll Integrations Public API
  description: Public API for Payroll Integrations platform
  version: '2025-10-28T20:05:03Z'
  license:
    name: MIT
servers:
  - url: https://api.payrollintegrationsapp.com
    description: Prod environment
  - url: https://demo1-api.payrollintegrationsdemo.com
    description: Demo environment
  - url: https://demo2-api.payrollintegrationsdemo.com
    description: Demo environment
  - url: https://demo3-api.payrollintegrationsdemo.com
    description: Demo environment
security:
  - bearerAuth: []
paths:
  /v1/employer-identifiers/{employer_identifier}/employee-aliases/resolve:
    post:
      tags:
        - Employee Data
      summary: Resolve employee aliases
      description: >-
        Accepts a list of employee aliases (e.g. SSNs) and returns their
        corresponding UUIDs.
      operationId: resolveEmployeeAliases
      parameters:
        - name: employer_identifier
          in: path
          description: UUID of the employer identifier
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        description: >-
          Contains a list of employee aliases to match to their corresponding
          UUIDs
        content:
          application/json:
            schema:
              $ref: 626f78bf-a69b-4ad8-a108-0d7ebd006ec8
            example:
              aliases:
                - type: SSN
                  value: 123-45-6789
                - type: SSN
                  value: 987-65-4321
                - type: SSN
                  value: 999-99-9999
      responses:
        '200':
          description: >-
            Resolved alias mappings for each provided alias, returns an empty
            array if no match is found
          content:
            application/json:
              schema:
                $ref: e2421d57-807f-41fa-bb2f-47d7b1de113d
              example:
                data:
                  - alias:
                      type: SSN
                      value: 123-45-6789
                    records:
                      - employeeProfileIds:
                          - 11111111-1111-1111-1111-111111111111
                          - 22222222-2222-2222-2222-222222222222
                        payrollConnectionId: 33333333-3333-3333-3333-333333333333
                        employeeId: 55555555-5555-5555-5555-555555555555
                  - alias:
                      type: SSN
                      value: 987-65-4321
                    records:
                      - employeeProfileIds:
                          - 44444444-4444-4444-4444-444444444444
                        payrollConnectionId: 33333333-3333-3333-3333-333333333333
                        employeeId: 66666666-6666-6666-6666-666666666666
                  - alias:
                      type: SSN
                      value: 999-99-9999
                    records: []
        '400':
          description: Bad Request - Invalid request body or validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - authentication credentials are missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not Found - Employer identifier does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - message
      properties:
        message:
          type: string
          description: Error message describing what went wrong
        errors:
          type: array
          description: Optional array of detailed error messages
          items:
            type: string

````