Retrieve a file record

Request

Retrieves a file with a specified ID.
Security
SecretApiKey or JWT
Path
idstring, <= 50 characters^[@~\-\.\w]+$required
ID of the resource.
curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/files/{id}' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'

Responses

File retrieved.
Bodyapplication/json
idstring, <= 50 charactersread-only
ID of the file.
Example:"file_0YV7HZ7KDCC5WBV9Q7WRKG1H6N"
namestring, <= 255 characters
Original file name.
extensionstring
File extension.
descriptionstring, <= 255 characters
Description of the file.
sourceTypestring or null
Source of the file.
Enum:"upload""camera""organization-export""organization-closure-export"null
Example:"upload"
tagsArray of strings
List of tags associated with the file.
mimestringread-only
MIME type of the file.
Enum:"image/png""image/jpeg""image/gif""image/webp""image/svg+xml""application/pdf""application/json""application/zip""text/csv"
sizeintegerread-only
File size, in bytes.
widthinteger or nullread-only
Width of the image. This field is applicable to images only.
heightinteger or nullread-only
Height of the image. This field is applicable to images only.
sha1stringread-only
Hash sum of the file.
exifDataobject or nullread-only
Collection of EXIF tags contained in the image metadata. This field is applicable to images only.
Example:
{
  "FileSize": 120,
  "Software": "GIMP 2.4.5"
}
createdTimestring, (date-time)(CreatedTime)read-only
Date and time when the resource is created. This value is set automatically when the resource is created.
updatedTimestring, (date-time)(UpdatedTime)read-only
Date and time when the resource is updated. This value is set automatically when the resource is updated.
isPublicboolean

Specifies if the file is available publicly without authentication. If this value is true, the permalink and cdn links in the _links section contain the public URLs. The cdn link is served from a cache and accepts the imageSize query parameter for images. If the organization has a verified media domain with no verification failure, the cdn link uses that domain. For more information, see Configure a custom domain.

_linksArray of objectsread-only
Related links.
Response
{
  "id": "file_0YV7HZ7KDCC5WBV9Q7WRKG1H6N",
  "name": "string",
  "extension": "string",
  "description": "string",
  "sourceType": "upload",
  "tags": [
    "string"
  ],
  "mime": "image/png",
  "size": 0,
  "width": 0,
  "height": 0,
  "sha1": "string",
  "exifData": {
    "FileSize": 120,
    "Software": "GIMP 2.4.5"
  },
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "isPublic": true,
  "_links": [
    { … }
  ]
}