Get Employee Photo

Returns an employee photo at the requested size. Available sizes are: original (full resolution), large (340×340), medium (170×170), small (150×150), xs (50×50), and tiny (20×20). The response shape is selected via standard HTTP content negotiation: by default the body is the stored image bytes and the Content-Type response header matches the body (image/jpeg, image/png, image/bmp, image/gif, or image/tiff). When the caller sends Accept: application/json (typical MCP/LLM-connector usage), the body is a JSON object { mimeType, fileBase64 } with the same image bytes base64-encoded, and the response Content-Type is application/json.

A 404 response covers three distinct cases: (1) the employee exists but has no photo on file (a normal, non-error state), (2) the employee ID does not exist, or (3) the size value is not one of the recognized options. The x-bamboohr-error-message response header distinguishes them: Employee photo not found, Employee not found, or Size: "<value>" is not a valid size option. Valid sizes are: xs, small, tiny, original, medium and large.. Treat "Employee photo not found" as a normal "no photo on file" result rather than as a bad employee ID, permission failure, or other error to debug.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the employee whose photo to retrieve.

string
enum
required

The desired photo size. One of: original, large, medium, small, xs, tiny.

Allowed:
Query Params
integer

Optional. Scales the returned image to the specified pixel width, capped at the natural width of the requested size. Only applies to small and tiny sizes.

integer

Optional. Scales the returned image to the specified pixel height, capped at the natural height of the requested size. Only applies to small and tiny sizes.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

403

The authenticated user does not have permission to view this employee's photo.

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*