Get picture (v1.0)

Retrieve the properties and relationships of a picture object for Business Central.

HTTP request

Replace the URL prefix for Business Central depending on environment following the guideline.s

GET businesscentralPrefix/companies({companyId})/items({itemId})/picture
GET businesscentralPrefix/companies({companyId})/employee({employeeId})/picture
GET businesscentralPrefix/companies({companyId})/vendor({vendorId})/picture
GET businesscentralPrefix/companies({companyId})/customer({customerId})/picture

Request headers (v1.0)

Header Value
Authorization Bearer {token}. Required.

Response (v1.0)

If successful, this method returns a 200 OK response code and a picture object in the response body.

Example (v1.0)

Request

Here is an example of the request.

GET Metadata

GET https://{businesscentralPrefix}/api/v1.0/companies(companyId)/items(itemId)/picture(itemId)

Response

Here is an example of the response.

Note

The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

{
  "id": "d0e5d5da-795a-4924-b376-13665f794cdd",
  "width": 500,
  "height": 496,
  "contentType": "image\jpeg",
  "content@odata.mediaEditLink": "https:\\api.businesscentral.dynamics-tie.com\v1.0\api\beta\companies(55c438d0-2f5c-44a0-9965-20b4923d0bef)\items(d0e5d5da-795a-4924-b376-13665f794cdd)\picture(d0e5d5da-795a-4924-b376-13665f794cdd)\content",
  "content@odata.mediaReadLink": "https:\\api.businesscentral.dynamics-tie.com\v1.0\api\beta\companies(55c438d0-2f5c-44a0-9965-20b4923d0bef)\items(d0e5d5da-795a-4924-b376-13665f794cdd)\picture(d0e5d5da-795a-4924-b376-13665f794cdd)\content"
}

GET Content

GET https://{businesscentralPrefix}/api/v1.0/companies(companyId)/items(itemId)/picture(itemId)/content

Response

Body is the raw image data.

Tips for working with the APIs

Error Codes

Error Codes
Picture
Create Picture
Update Picture
Delete Picture