Photo
API version
Select a version to change the base URI
in syntax and code examples. Learn about versions:
in syntax and code examples. Learn about versions
Represents the photo of an applicant.
URI
/api/v10/applicants/ID/photoGET Get a photo
Retrieve the photo data of an applicant.
Syntax
GET /api/v10/applicants/123/photo
Host: apply.example.edu
Authorization: DREAM apikey="..."Parameters
| Name | Required/Optional | Description | Notes |
|---|---|---|---|
size | Optional | The requested transformed size of the photo. Allowed values: S, M, L, R, F. | The default value is F, which applies the existing transformations. The R value can skip all transformations and return a raw image. |
Example request
Request
curl
curl \
-X GET \
-H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
-o ~/Downloads/photo_123.jpeg \
"https://apply.example.edu/api/v10/applicants/123/photo?size=S"Response headers
| Header | Value | Description |
|---|---|---|
Content-Type | image/jpeg | The media type of the resource |
Content-Length | 1234 | The size of the response body in bytes |
Response codes
| Response code | Description |
|---|---|
200 OK | The applicant’s binary photo was successfully returned |
404 Not Found | The applicant does not have a photo |