curl -X GET "https://api-integration.ollang.com/integration/folder/60b8d6f1e1b9b1d8c6c0d8e1/docs" \
-H "X-Api-Key: <your-api-key>"
const folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
const response = await fetch(
`https://api-integration.ollang.com/integration/folder/${folderId}/docs`,
{
method: "GET",
headers: {
"X-Api-Key": "<your-api-key>",
},
},
);
const docs = await response.json();
console.log(`${docs.length} folder documents`);
import requests
folder_id = "60b8d6f1e1b9b1d8c6c0d8e1"
response = requests.get(
f"https://api-integration.ollang.com/integration/folder/{folder_id}/docs",
headers={"X-Api-Key": "<your-api-key>"},
)
for doc in response.json():
print(doc["type"], doc["name"])
$folderId = '60b8d6f1e1b9b1d8c6c0d8e1';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api-integration.ollang.com/integration/folder/{$folderId}/docs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'X-Api-Key: <your-api-key>'
),
));
$response = curl_exec($curl);
$docs = json_decode($response, true);
curl_close($curl);
echo "Folder documents: " . count($docs);
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
folderID := "60b8d6f1e1b9b1d8c6c0d8e1"
url := "https://api-integration.ollang.com/integration/folder/" + folderID + "/docs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("X-Api-Key", "<your-api-key>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var docs []map[string]interface{}
json.Unmarshal(body, &docs)
fmt.Println("Folder documents:", len(docs))
}
String folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
HttpResponse<String> response = Unirest
.get("https://api-integration.ollang.com/integration/folder/" + folderId + "/docs")
.header("X-Api-Key", "<your-api-key>")
.asString();
JSONArray docs = new JSONArray(response.getBody());
System.out.println("Folder documents: " + docs.length());
[
{
"id": "60b8d6f1e1b9b1d8c6c0d8f1",
"name": "Brand guideline v3",
"type": "guideline",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/brand-guideline-v3.pdf",
"size": 481203,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:14:22.511Z",
"updatedAt": "2026-09-02T10:14:22.511Z"
},
{
"id": "60b8d6f1e1b9b1d8c6c0d8f2",
"name": "Product terminology",
"type": "guideline_glossary",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/product-terminology.xlsx",
"size": 20418,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:16:03.882Z",
"updatedAt": "2026-09-02T10:16:03.882Z"
}
]
{
"error": "Unauthorized",
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
{
"statusCode": 404,
"message": "Folder not found",
"error": "Not Found"
}
Ollang API Reference
List Folder Documents
List the guideline, glossary, and character-list documents attached to a folder
GET
/
integration
/
folder
/
{folderId}
/
docs
curl -X GET "https://api-integration.ollang.com/integration/folder/60b8d6f1e1b9b1d8c6c0d8e1/docs" \
-H "X-Api-Key: <your-api-key>"
const folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
const response = await fetch(
`https://api-integration.ollang.com/integration/folder/${folderId}/docs`,
{
method: "GET",
headers: {
"X-Api-Key": "<your-api-key>",
},
},
);
const docs = await response.json();
console.log(`${docs.length} folder documents`);
import requests
folder_id = "60b8d6f1e1b9b1d8c6c0d8e1"
response = requests.get(
f"https://api-integration.ollang.com/integration/folder/{folder_id}/docs",
headers={"X-Api-Key": "<your-api-key>"},
)
for doc in response.json():
print(doc["type"], doc["name"])
$folderId = '60b8d6f1e1b9b1d8c6c0d8e1';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api-integration.ollang.com/integration/folder/{$folderId}/docs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'X-Api-Key: <your-api-key>'
),
));
$response = curl_exec($curl);
$docs = json_decode($response, true);
curl_close($curl);
echo "Folder documents: " . count($docs);
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
folderID := "60b8d6f1e1b9b1d8c6c0d8e1"
url := "https://api-integration.ollang.com/integration/folder/" + folderID + "/docs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("X-Api-Key", "<your-api-key>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var docs []map[string]interface{}
json.Unmarshal(body, &docs)
fmt.Println("Folder documents:", len(docs))
}
String folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
HttpResponse<String> response = Unirest
.get("https://api-integration.ollang.com/integration/folder/" + folderId + "/docs")
.header("X-Api-Key", "<your-api-key>")
.asString();
JSONArray docs = new JSONArray(response.getBody());
System.out.println("Folder documents: " + docs.length());
[
{
"id": "60b8d6f1e1b9b1d8c6c0d8f1",
"name": "Brand guideline v3",
"type": "guideline",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/brand-guideline-v3.pdf",
"size": 481203,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:14:22.511Z",
"updatedAt": "2026-09-02T10:14:22.511Z"
},
{
"id": "60b8d6f1e1b9b1d8c6c0d8f2",
"name": "Product terminology",
"type": "guideline_glossary",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/product-terminology.xlsx",
"size": 20418,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:16:03.882Z",
"updatedAt": "2026-09-02T10:16:03.882Z"
}
]
{
"error": "Unauthorized",
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
{
"statusCode": 404,
"message": "Folder not found",
"error": "Not Found"
}
Returns the folder-level documents attached to a folder: guidelines, guideline glossaries, and character lists. These documents apply to every project inside the folder, so they are the API equivalent of the Guidelines panel on a folder in the dashboard.
Only the three folder-level document types are returned. Source files attached to individual projects are not included.
curl -X GET "https://api-integration.ollang.com/integration/folder/60b8d6f1e1b9b1d8c6c0d8e1/docs" \
-H "X-Api-Key: <your-api-key>"
const folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
const response = await fetch(
`https://api-integration.ollang.com/integration/folder/${folderId}/docs`,
{
method: "GET",
headers: {
"X-Api-Key": "<your-api-key>",
},
},
);
const docs = await response.json();
console.log(`${docs.length} folder documents`);
import requests
folder_id = "60b8d6f1e1b9b1d8c6c0d8e1"
response = requests.get(
f"https://api-integration.ollang.com/integration/folder/{folder_id}/docs",
headers={"X-Api-Key": "<your-api-key>"},
)
for doc in response.json():
print(doc["type"], doc["name"])
$folderId = '60b8d6f1e1b9b1d8c6c0d8e1';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api-integration.ollang.com/integration/folder/{$folderId}/docs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => array(
'X-Api-Key: <your-api-key>'
),
));
$response = curl_exec($curl);
$docs = json_decode($response, true);
curl_close($curl);
echo "Folder documents: " . count($docs);
package main
import (
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
folderID := "60b8d6f1e1b9b1d8c6c0d8e1"
url := "https://api-integration.ollang.com/integration/folder/" + folderID + "/docs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("X-Api-Key", "<your-api-key>")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var docs []map[string]interface{}
json.Unmarshal(body, &docs)
fmt.Println("Folder documents:", len(docs))
}
String folderId = "60b8d6f1e1b9b1d8c6c0d8e1";
HttpResponse<String> response = Unirest
.get("https://api-integration.ollang.com/integration/folder/" + folderId + "/docs")
.header("X-Api-Key", "<your-api-key>")
.asString();
JSONArray docs = new JSONArray(response.getBody());
System.out.println("Folder documents: " + docs.length());
Authorizations
This endpoint requires API key authentication. Include your API key in the request header:- Header name:
X-Api-Key - Header value: Your API key from the Ollang dashboard
- Format:
X-Api-Key: your-api-key-here
Path Parameters
string
required
The unique identifier of the folder. Retrieve folder IDs with Retrieve All
Folders.
Response
An array of folder document objects.string
Unique identifier of the document. Pass this to Remove Folder
Document to detach it.
string
Display name of the document.
string
One of
guideline, guideline_glossary, or character_list.string
Location of the stored document.
number
Size of the document in bytes. May be
null for documents attached without a
size.string
Language of the document, when one was supplied at attach time.
null
otherwise.string
Identifier of the folder the document belongs to.
string
Identifier of the account that owns the document.
string
When the document was attached, in ISO 8601 format.
string
When the document was last updated, in ISO 8601 format.
[
{
"id": "60b8d6f1e1b9b1d8c6c0d8f1",
"name": "Brand guideline v3",
"type": "guideline",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/brand-guideline-v3.pdf",
"size": 481203,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:14:22.511Z",
"updatedAt": "2026-09-02T10:14:22.511Z"
},
{
"id": "60b8d6f1e1b9b1d8c6c0d8f2",
"name": "Product terminology",
"type": "guideline_glossary",
"url": "https://ollang-docs.s3.eu-central-1.amazonaws.com/60b8d6f1e1b9b1d8c6c0d8e5/product-terminology.xlsx",
"size": 20418,
"sourceLanguage": "en",
"folderId": "60b8d6f1e1b9b1d8c6c0d8e1",
"clientId": "60b8d6f1e1b9b1d8c6c0d8e5",
"createdAt": "2026-09-02T10:16:03.882Z",
"updatedAt": "2026-09-02T10:16:03.882Z"
}
]
{
"error": "Unauthorized",
"message": "Invalid or missing API key",
"code": "UNAUTHORIZED"
}
{
"statusCode": 404,
"message": "Folder not found",
"error": "Not Found"
}
Was this page helpful?