Get files

Retrieve a file using its encrypted ID.

Endpoints

Request URL

Bigin APIs are available across eight different domains, and you must choose the one relevant to your data center (DC):

  • US
  • EU
  • AU
  • IN
  • CN
  • JP
  • SA
  • CA
GEThttps://www.zohoapis.com/bigin/v2/files 
GEThttps://www.zohoapis.eu/bigin/v2/files 
GEThttps://www.zohoapis.com.au/bigin/v2/files 
GEThttps://www.zohoapis.in/bigin/v2/files 
GEThttps://www.zohoapis.com.cn/bigin/v2/files 
GEThttps://www.zohoapis.jp/bigin/v2/files 
GEThttps://www.zohoapis.sa/bigin/v2/files 
GEThttps://www.zohoapis.ca/bigin/v2/files 

Authorization

For this endpoint, pass the access token as an authorization header. See OAuth Authentication for more information about access tokens.

Authorization: Zoho-oauthtoken <ACCESS_TOKEN>

You must authenticate using an access token that is associated with the following scope:

  • ZohoBigin.Files.READ

Request parameters

The available request parameters are given below:

Query parameters

id stringRequired

The encrypted ID of a file that you'll receive when you upload files to Bigin.

Sample request

Copiedcurl "https://www.zohoapis.com/bigin/v2/files?id=2cceafahsjdhsdhc065186" \
-X GET \
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Possible error codes

The response of this resource includes HTTP status and error codes.