Download an Object and All its Children
curl --request GET \
--url https://app.speckle.systems/objects/{projectId}/{objectId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.speckle.systems/objects/{projectId}/{objectId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.speckle.systems/objects/{projectId}/{objectId}', 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://app.speckle.systems/objects/{projectId}/{objectId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://app.speckle.systems/objects/{projectId}/{objectId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.speckle.systems/objects/{projectId}/{objectId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.speckle.systems/objects/{projectId}/{objectId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "9b2cdb21da092dbd3558a4bc55b2cf7e",
"speckle_type": "Base",
"totalChildrenCount": 0,
"numbers": [
0.04667752874618203,
0.16370857295385177,
0.1008153029515465
]
}
]{
"message": "<string>",
"statusCode": 123
}{
"message": "<string>",
"statusCode": 123
}Object endpoints (legacy)
Download an Object and All its Children
deprecated
Download an object and all of its children recursively. The response format depends on the Accept header. Public projects need no token. On Speckle Cloud and Speckle Enterprise Server 2026.9 and later, this endpoint is deprecated: every response carries Deprecation and Warning headers, and it serves object-graph versions only. On the open-source Speckle Server it is current. A bundle reference (bundle.<projectId>.<modelId>.<versionId>) returns 404 with error: "BUNDLE_REFERENCE_NOT_FOUND": read bundle versions with the artifacts endpoints instead.
GET
/
objects
/
{projectId}
/
{objectId}
Download an Object and All its Children
curl --request GET \
--url https://app.speckle.systems/objects/{projectId}/{objectId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.speckle.systems/objects/{projectId}/{objectId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.speckle.systems/objects/{projectId}/{objectId}', 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://app.speckle.systems/objects/{projectId}/{objectId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://app.speckle.systems/objects/{projectId}/{objectId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.speckle.systems/objects/{projectId}/{objectId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.speckle.systems/objects/{projectId}/{objectId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "9b2cdb21da092dbd3558a4bc55b2cf7e",
"speckle_type": "Base",
"totalChildrenCount": 0,
"numbers": [
0.04667752874618203,
0.16370857295385177,
0.1008153029515465
]
}
]{
"message": "<string>",
"statusCode": 123
}{
"message": "<string>",
"statusCode": 123
}Deprecated on Speckle Cloud and Speckle Enterprise Server 2026.9 and later, where it serves object graphs only. Current on the open-source Speckle Server. To read a bundle version, use the bundle endpoints.
Response Format
- If
Acceptistext/plain, each line of the output contains 1 object in the format:{object_id}\t{object_content} - If
Acceptisapplication/json, the output is a JSON representation of an array of objects.