---
updatedAt: 2026-08-16T05:24:11.000Z
agentTools:
  projectIndex: https://docs.wirexapp.com/llms.txt
---

# Search employees

Searches employees by term (required unless manager_address is provided) and/or manager address with pagination.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "response.AddressResponse": {
        "properties": {
          "city": {
            "example": "San Francisco",
            "type": "string"
          },
          "country": {
            "example": "US",
            "type": "string"
          },
          "line1": {
            "example": "123 Main St",
            "type": "string"
          },
          "line2": {
            "example": "Apt 101",
            "type": "string"
          },
          "postal_code": {
            "example": "94107",
            "type": "string"
          },
          "state": {
            "example": "CA",
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.EmployeeResponse": {
        "properties": {
          "corporation_address": {
            "example": "0xA7E41d5680dE394EaA2ed417169DFf56840Fb3EE",
            "type": "string"
          },
          "created_at": {
            "example": "2026-02-13T10:00:00Z",
            "type": "string"
          },
          "department": {
            "example": "Finance",
            "type": "string"
          },
          "email": {
            "example": "a.white@acme.com",
            "type": "string"
          },
          "first_name": {
            "example": "Alex",
            "type": "string"
          },
          "id": {
            "example": "00000000-0000-0000-0000-000000000001",
            "type": "string"
          },
          "job_title": {
            "example": "Analyst",
            "type": "string"
          },
          "last_name": {
            "example": "Grey",
            "type": "string"
          },
          "manager_address": {
            "example": "0xA7E41d5680dE394EaA2ed417169DFf56840Fb3EE",
            "type": "string"
          },
          "manager_name": {
            "example": "John Smith",
            "type": "string"
          },
          "owner_address": {
            "example": "0xA7E41d5680dE394EaA2ed417169DFf56840Fb3EE",
            "type": "string"
          },
          "phone": {
            "example": "+15551234567",
            "type": "string"
          },
          "residence_address": {
            "$ref": "#/components/schemas/response.AddressResponse"
          },
          "role_id": {
            "example": "00000000-0000-0000-0000-000000000001",
            "type": "string"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/response.EmployeeStatus"
              }
            ],
            "example": "Active"
          },
          "updated_at": {
            "example": "2026-02-13T10:00:00Z",
            "type": "string"
          }
        },
        "required": [
          "corporation_address",
          "created_at",
          "email",
          "id",
          "role_id",
          "status",
          "updated_at"
        ],
        "type": "object"
      },
      "response.EmployeeStatus": {
        "enum": [
          "Invalid",
          "Invited",
          "Active",
          "Disabled"
        ],
        "type": "string",
        "x-enum-varnames": [
          "EmployeeStatusInvalid",
          "EmployeeStatusInvited",
          "EmployeeStatusActive",
          "EmployeeStatusDisabled"
        ]
      },
      "response.EmployeesResponse": {
        "properties": {
          "employees": {
            "items": {
              "$ref": "#/components/schemas/response.EmployeeResponse"
            },
            "type": "array"
          }
        },
        "required": [
          "employees"
        ],
        "type": "object"
      },
      "response.ErrorCategory": {
        "properties": {
          "category": {
            "type": "string"
          },
          "grpc_status_code": {
            "type": "integer"
          },
          "http_status_code": {
            "type": "integer"
          }
        },
        "type": "object"
      },
      "response.ErrorDetails": {
        "properties": {
          "details": {
            "type": "string"
          },
          "key": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ErrorReason": {
        "properties": {
          "reason": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "response.ErrorResponse": {
        "properties": {
          "error_category": {
            "$ref": "#/components/schemas/response.ErrorCategory"
          },
          "error_description": {
            "type": "string"
          },
          "error_details": {
            "items": {
              "$ref": "#/components/schemas/response.ErrorDetails"
            },
            "type": "array"
          },
          "error_reason": {
            "$ref": "#/components/schemas/response.ErrorReason"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "WirexPayCorpToken": {
        "description": "Self-signed JWT token that can be obtained by logging in to the Wirex Corporate platform using its own authorization APIs.",
        "in": "header",
        "name": "Authorization",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "contact": {
      "email": "company@wirexpaychain.com",
      "name": "API Support Team"
    },
    "description": "The **Wirex Corporate API** provides businesses with a seamless way to manage corporate finances using blockchain technology. It supports corporate registration, KYB verification, employee onboarding, corporate card issuance, and SEPA/ACH bank transfers—all without direct fiat interaction. Transactions are executed directly from a **non-custodial crypto account**, ensuring security, transparency, and full control over funds.",
    "title": "Wirex Corporate BaaS API",
    "version": "1.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/v1/employees/search": {
      "get": {
        "description": "Searches employees by term (required unless manager_address is provided) and/or manager address with pagination.",
        "parameters": [
          {
            "description": "Search term (required if manager_address is not provided)",
            "in": "query",
            "name": "term",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter by manager address (0x-prefixed EVM address)",
            "in": "query",
            "name": "manager_address",
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Page number",
            "in": "query",
            "name": "page_number",
            "schema": {
              "type": "integer"
            }
          },
          {
            "description": "Page size (default 25, max 100)",
            "in": "query",
            "name": "page_size",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.EmployeesResponse"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Bad Request"
          },
          "500": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/response.ErrorResponse"
                }
              }
            },
            "description": "Internal Server Error"
          }
        },
        "security": [
          {
            "WirexPayCorpToken": [
              "su",
              "su:employee",
              "w:employee",
              "r:employee"
            ]
          }
        ],
        "summary": "Search employees",
        "tags": [
          "Employees"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api-business.wirexapp.com"
    },
    {
      "url": "https://api-corporate.wirexpaychain.tech"
    }
  ],
  "tags": [
    {
      "description": "The **Employee APIs** streamline operations related to managing employees within a corporation. These APIs enable administrators to perform\nessential employee-related tasks while ensuring secure and efficient access control.\n\n### Key Features:\n\n- **Flexible Role Management**:\n    - Define and customize roles and permissions to meet organizational requirements.\n    - Ensure employees have appropriate access levels tailored to their responsibilities.\n\n- **Efficient Employee Operations**:\n    - Easily handle additions, updates, and removals of employees for organizations of any size.\n    - Adaptable to both small-scale businesses and large enterprises.\n\n- **Secure Data Handling**:\n    - Leverages integration with secure authorization protocols to restrict access to authorized users.\n    - Safeguards sensitive employee information with advanced security practices.\n\n---\n\nWith Employee APIs, administrators can manage corporate teams efficiently while maintaining a structured, secure, and organized workflow.\nThese tools simplify tasks such as onboarding, updating employee roles, and handling permissions, ensuring seamless organizational\nmanagement.",
      "name": "Employees"
    }
  ],
  "x-readme": {}
}
```