Get files

Retrieve a file using its encrypted ID.

Endpoints

Request URL

{api-domain}/bigin/v2/files

Choose domain-specific URL to replace {api-domain}

You can use the domain-specific URL to access Bigin resources. Based on the data center in which the Bigin account's resources are available, replace {api-domain} in the preceding request with one of the following API domain URLs:

  • For US, https://www.zohoapis.com
  • For EU, https://www.zohoapis.eu
  • For AU, https://www.zohoapis.com.au
  • For IN, https://www.zohoapis.in
  • For CN, https://www.zohoapis.com.cn
  • For JP, https://www.zohoapis.jp

For more information, see Multi DC Support.

 

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.