List published references
Returns the company's published references (API channel) as a paginated list.
The response is a bare JSON array without a pagination envelope — use
mode=countonly in a separate call to obtain the total count.
The mode parameter switches the payload shape:
paging/full(default) — array of full list itemsIDonly— array of{ reference_ID }optionsonly— array of{ reference_ID, projecttitle }countonly— a bare integer (total count)
curl -X GET "https://referenzen.com/api/v1/references/referenceprojects?mode=paging&lang_ID=2&idList=example_string&branch_ID=example_string&branch_lft=0&branch_rgt=0&referencegroup_ID=example_string&workfield_ID=example_string&markerlist_ID=0&confirmed=false&ongoing=false&withoutreference_ID=example_string&getclientdetails=false&getadmininfo=false&format=list&records=0&page=1&orderby=sortorder" \
-H "Content-Type: application/json"
import requests
import json
url = "https://referenzen.com/api/v1/references/referenceprojects?mode=paging&lang_ID=2&idList=example_string&branch_ID=example_string&branch_lft=0&branch_rgt=0&referencegroup_ID=example_string&workfield_ID=example_string&markerlist_ID=0&confirmed=false&ongoing=false&withoutreference_ID=example_string&getclientdetails=false&getadmininfo=false&format=list&records=0&page=1&orderby=sortorder"
headers = {
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://referenzen.com/api/v1/references/referenceprojects?mode=paging&lang_ID=2&idList=example_string&branch_ID=example_string&branch_lft=0&branch_rgt=0&referencegroup_ID=example_string&workfield_ID=example_string&markerlist_ID=0&confirmed=false&ongoing=false&withoutreference_ID=example_string&getclientdetails=false&getadmininfo=false&format=list&records=0&page=1&orderby=sortorder", {
method: "GET",
headers: {
"Content-Type": "application/json"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://referenzen.com/api/v1/references/referenceprojects?mode=paging&lang_ID=2&idList=example_string&branch_ID=example_string&branch_lft=0&branch_rgt=0&referencegroup_ID=example_string&workfield_ID=example_string&markerlist_ID=0&confirmed=false&ongoing=false&withoutreference_ID=example_string&getclientdetails=false&getadmininfo=false&format=list&records=0&page=1&orderby=sortorder", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://referenzen.com/api/v1/references/referenceprojects?mode=paging&lang_ID=2&idList=example_string&branch_ID=example_string&branch_lft=0&branch_rgt=0&referencegroup_ID=example_string&workfield_ID=example_string&markerlist_ID=0&confirmed=false&ongoing=false&withoutreference_ID=example_string&getclientdetails=false&getadmininfo=false&format=list&records=0&page=1&orderby=sortorder')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
response = http.request(request)
puts response.body
[
{
"reference_ID": 4711,
"projecttitle": "Harbor Bridge Renovation",
"subtitle": "example_string",
"displayedlocation": "Hamburg, Germany",
"country": "USA",
"region": "example_string",
"city": "New York",
"location": "example_string",
"latitude": 3.14,
"longitude": 3.14,
"date": "example_string",
"thumbnail": "example_string",
"uniquename": "John Doe",
"referencedetailpagelink": "example_string",
"seolabel": "example_string",
"company": {
"company_ID": 123,
"companyname": "John Doe",
"detailpagelink": "example_string",
"address": "123 Main St",
"address2": "123 Main St",
"zip": "example_string",
"city": "New York",
"region": "example_string",
"country": "USA"
},
"status": 42,
"projectstatus": 42,
"ispublished": true,
"iscountersigned": true,
"datecountersigned": "example_string",
"countersignstatus": 10,
"isfeatured": true,
"referencetype_ID": 123,
"datecreated": "example_string",
"client": {
"displayedname": "a leading logistics company",
"displayedclientname": "John Doe",
"address": "123 Main St",
"address2": "123 Main St",
"zip": "example_string",
"city": "New York",
"detailpagelink": "example_string",
"mainbranch": "example_string",
"contact_name": "John Doe",
"contact_jobtitle": "example_string"
},
"dateupdated": "example_string",
"updated_by": "example_string"
}
]
42
{}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
/references/referenceprojects
Target server for requests. Edit to use your own host.
Your API key (workspace → avatar menu → Settings → API). Scopes all requests to your company.
Payload shape (see endpoint description).
Content language: 1 = English, 2 = German. Invalid values fall back to the key owner's default language.
Comma-separated list of reference IDs to fetch explicitly (bypasses other filters).
Filter by industry branch — single ID or comma-separated list.
Nested-set left bound — include all sub-branches of a branch (use together with branch_rgt).
Nested-set right bound (see branch_lft).
Filter by reference group — single ID or comma-separated list.
Filter by work field — single ID or comma-separated list.
Filter by a marker list (watchlist) ID.
Only client-confirmed (countersigned) references.
Only ongoing projects.
Exclude these reference IDs (comma-separated).
Include the client sub-object on each item.
Include dateupdated / updated_by fields.
Thumbnail size variant.
Page size (0 = no paging).
Sort order.
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Your API key (workspace → avatar menu → Settings → API). Scopes all requests to your company.
Query Parameters
Payload shape (see endpoint description).
pagingfulloptionsonlyIDonlycountonlyContent language: 1 = English, 2 = German. Invalid values fall back to the key owner's default language.
12Comma-separated list of reference IDs to fetch explicitly (bypasses other filters).
Filter by industry branch — single ID or comma-separated list.
Nested-set left bound — include all sub-branches of a branch (use together with branch_rgt).
Nested-set right bound (see branch_lft).
Filter by reference group — single ID or comma-separated list.
Filter by work field — single ID or comma-separated list.
Filter by a marker list (watchlist) ID.
Only client-confirmed (countersigned) references.
Only ongoing projects.
Exclude these reference IDs (comma-separated).
Include the client sub-object on each item.
Include dateupdated / updated_by fields.
Page size (0 = no paging).
Sort order.
nonereference_IDreference_ID descdatefromdatefrom descdateuntildateuntil descprojecttitleprojecttitle descsortordermarkerlistsortorderlastviewdatecountersignrequestedrandomResponses
Formatted project date/range.
CDN URL of the list image.
Public detail page URL on the platform.
Approval status code.
Client-confirmed (verified) reference.
Client info, shaped by the client's display type. Anonymized clients deliver only
displayedname; named corporate clients may include address, profile link, and —
where allowed — contact person name and job title.
Only with getadmininfo=true.
Only with getadmininfo=true.