Get File
curl --request GET \
--url https://api.example.com/v1/files/{id}import requests
url = "https://api.example.com/v1/files/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/files/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/files/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/files/{id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/files/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/files/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"folder": "<string>",
"size": 123,
"type": "<string>",
"private": true,
"expires_at": "<string>",
"created_at": "<string>"
}Files
Get File
Get metadata for a specific file.
GET
/
v1
/
files
/
{id}
Get File
curl --request GET \
--url https://api.example.com/v1/files/{id}import requests
url = "https://api.example.com/v1/files/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/v1/files/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/files/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/files/{id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/files/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/files/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "<string>",
"url": "<string>",
"name": "<string>",
"folder": "<string>",
"size": 123,
"type": "<string>",
"private": true,
"expires_at": "<string>",
"created_at": "<string>"
}Retrieve metadata for a specific file by its ID.
Path Parameters
string
required
The file ID. Example:
f_abc123xyzResponse
string
required
Unique file identifier.
string
Public URL (null for private files).
string
required
Original filename.
string
Folder path, or null if at root.
integer
required
File size in bytes.
string
required
MIME type.
boolean
required
Whether file requires signed URL.
string
Auto-delete timestamp, or null.
string
required
Upload timestamp.
Example
curl https://api.stashfyle.com/v1/files/f_abc123xyz \
-H "Authorization: Bearer sk_live_xxx"
const response = await fetch('https://api.stashfyle.com/v1/files/f_abc123xyz', {
headers: { 'Authorization': 'Bearer sk_live_xxx' }
});
const file = await response.json();
response = requests.get(
'https://api.stashfyle.com/v1/files/f_abc123xyz',
headers={'Authorization': 'Bearer sk_live_xxx'}
)
file = response.json()
Response
{
"id": "f_abc123xyz",
"url": "https://cdn.stashfyle.com/live/user_123/f_abc123xyz/photo.jpg",
"name": "photo.jpg",
"folder": null,
"size": 248000,
"type": "image/jpeg",
"private": false,
"expires_at": null,
"created_at": "2024-01-15T10:30:00Z"
}
Errors
| Code | Status | Description |
|---|---|---|
unauthorized | 401 | Invalid or missing API key |
not_found | 404 | File not found or deleted |
⌘I