action squareup_get_v2_employees { label: "ListEmployees" description: "" provider: squareup method: GET path: "/v2/employees" encoding: json input: { type: "object" properties: { cursor: { type: "string" } limit: { type: "integer" } location_id: { type: "string" } status: { type: "string" } } additionalProperties: false } output: { type: "object" properties: { cursor: { type: "string" description: "The token to be used to retrieve the next page of results." } employees: { type: "array" items: { type: "object" description: "An employee object that is used by the external API." properties: { created_at: { type: "string" description: "A read-only timestamp in RFC 3339 format." } email: { type: "string" description: "The employee's email address" } first_name: { type: "string" description: "The employee's first name." } id: { type: "string" description: "UUID for this object." } is_owner: { type: "boolean" description: "Whether this employee is the owner of the merchant. Each merchant\nhas one owner employee, and that employee has full authority over\nthe account." } last_name: { type: "string" description: "The employee's last name." } location_ids: { type: "array" description: "A list of location IDs where this employee has access to." items: { type: "string" } } phone_number: { type: "string" description: "The employee's phone number in E.164 format, i.e. \"+12125554250\"" } status: { type: "string" description: "Specifies the status of the employees being fetched." } updated_at: { type: "string" description: "A read-only timestamp in RFC 3339 format." } } } } errors: { type: "array" description: "Any errors that occurred during the request." items: { type: "object" description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information." required: ["category", "code"] properties: { category: { type: "string" description: "The high-level category for the error." } code: { type: "string" description: "The specific code of the error." } detail: { type: "string" description: "A human-readable description of the error for debugging purposes." } field: { type: "string" description: "The name of the field provided in the original request (if any) that\nthe error pertains to." } } } } } } }