Get a unit's photo

Redirects (302) to a signed URL valid for a few minutes. Copy the image to your own storage if you need to keep it.

GET/inventory/items/{id}/photos/{side}

Authorization

AuthorizationOAuth2 access token · headerrequired

Authorization code flow (PKCE S256 required). Send resource=https://api.toreca-cloud.com/partner/v1 with the authorization, token and refresh requests. Access tokens last 15 minutes; refresh tokens last 90 days and rotate on every refresh.

Scopes:inventory:read

Path parameters

idstring<uuid>required

sidestringrequired

Allowed:frontback

Responses

302

Redirect to the signed URL

404

not_found

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

503

photo_unavailable

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*sidepath*

Request

curl -X GET 'https://api.toreca-cloud.com/partner/v1/inventory/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/photos/front' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const response: Response = await fetch("https://api.toreca-cloud.com/partner/v1/inventory/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/photos/front", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.toreca-cloud.com/partner/v1/inventory/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/photos/front",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

Redirect to the signed URL

{
  "error": "string",
  "scope": "string"
}

{
  "error": "string",
  "scope": "string"
}