DocumentationAPI Reference
API Reference

Get Employee Photo

get
https://{companyDomain}.bamboohr.com/api/v1/employees//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 server always sets Content-Type: image/jpeg, but the underlying byte payload may reflect the original upload format.

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.

Responses

403

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

404

The employee does not exist, no photo is on file, or an unrecognized size was specified.

Updated about 1 month ago

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here!

Updated about 1 month ago