Get Delivery References
curl --request GET \
--url https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references', 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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": null,
"payload": {
"references": [
{
"id": "cd0a3298-8798-4817-b78f-734d5e0fc095",
"citation_idx": 1,
"search_type": "external",
"chunk_id": "c063d35f-f143-4813-9d40-8733e5779b06",
"text": "Stock futures are climbing as President Donald Trump's deadline to reopen the Strait of Hormuz approaches.",
"text_type": "news",
"document_id": null,
"document_name": "Stock Market Today (Apr. 7, 2026): Futures climb ahead of Trump Iran deadline",
"s3_file_key": "https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates",
"external_url": "https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates",
"metadata": {
"source": "news",
"calendar_date": "2026-04-07"
}
},
{
"id": "f99d92bc-6d36-4c21-9f2b-2b7d57fa9c79",
"citation_idx": 10,
"search_type": "external",
"chunk_id": "b78e60cf-e0a2-420a-9da0-e2b5845a7ad0",
"text": "Franklin Resources Reports Lower March Assets Under Management. Franklin Resources (BEN) late Monday reported preliminary March assets under management of $1.68 trillion, down from $1.73 trillion in February.",
"text_type": "news",
"document_id": "b78e60cf-e0a2-420a-9da0-e2b5845a7ad0",
"document_name": "Franklin Resources Reports Lower March Assets Under Management",
"s3_file_key": null,
"external_url": "https://my.apps.factset.com/viewer-fusion/?_doc_id=A3596626&_doc_date=2026-04-06&_doc_product=MNW",
"metadata": {
"source": "news",
"rms_document_type": "news",
"calendar_date": "2026-04-06T17:09:34.000Z",
"document_category": "news",
"stock_ids": [
"BBG001S5P3W6"
],
"tickers": [
"BEN"
]
}
}
]
}
}Briefing
Get Delivery References
Retrieves the full list of citation references (sources) used to generate a briefing delivery.
Briefing email content includes inline citations [N] that point into this list via citation_idx. Use this endpoint to build custom UIs, export source lists, or link readers back to original documents.
Usage Flow:
- Get a delivery via List Deliveries or Get Delivery Detail — note the
chat_session_id - Verify delivery status is
sent - Call this endpoint with
delivery_id - For each reference, dispatch on
search_typeto build the viewer URL (see below)
How to view original documents (switch on search_type):
external/news— the reference already links to the source. Useexternal_urldirectly (Factset viewer URL for news, publisher URL for external).tfs(transcripts & filings) — open in the LinqAlpha document viewer:https://chat.eu.linqalpha.com/documents/{document_id}. To download the raw file, passdocument_idto the Presigned URL endpoint.rms(internal research, RMS-connected organizations) — open in the RMS viewer:https://chat.eu.linqalpha.com/rms/viewer?conversation_id={chat_session_id}&citation_idx={citation_idx}.chat_session_idcomes from the delivery detail response.
Error codes (returned in response body with HTTP 200):
BRIEFING_DELIVERY_NOT_FOUND—delivery_iddoes not exist or does not belong to your organizationBRIEFING_DELIVERY_REFERENCES_NOT_AVAILABLE— delivery exists but has no associated session (still pending or generation failed)GET_SESSION_REFERENCES_FAIL— upstream fetch failed
GET
/
v1
/
briefings
/
deliveries
/
{delivery_id}
/
references
Get Delivery References
curl --request GET \
--url https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references', 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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
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.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eu.linqalpha.com/v1/briefings/deliveries/{delivery_id}/references")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": null,
"payload": {
"references": [
{
"id": "cd0a3298-8798-4817-b78f-734d5e0fc095",
"citation_idx": 1,
"search_type": "external",
"chunk_id": "c063d35f-f143-4813-9d40-8733e5779b06",
"text": "Stock futures are climbing as President Donald Trump's deadline to reopen the Strait of Hormuz approaches.",
"text_type": "news",
"document_id": null,
"document_name": "Stock Market Today (Apr. 7, 2026): Futures climb ahead of Trump Iran deadline",
"s3_file_key": "https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates",
"external_url": "https://www.thestreet.com/latest-news/stock-market-today-apr-7-2026-updates",
"metadata": {
"source": "news",
"calendar_date": "2026-04-07"
}
},
{
"id": "f99d92bc-6d36-4c21-9f2b-2b7d57fa9c79",
"citation_idx": 10,
"search_type": "external",
"chunk_id": "b78e60cf-e0a2-420a-9da0-e2b5845a7ad0",
"text": "Franklin Resources Reports Lower March Assets Under Management. Franklin Resources (BEN) late Monday reported preliminary March assets under management of $1.68 trillion, down from $1.73 trillion in February.",
"text_type": "news",
"document_id": "b78e60cf-e0a2-420a-9da0-e2b5845a7ad0",
"document_name": "Franklin Resources Reports Lower March Assets Under Management",
"s3_file_key": null,
"external_url": "https://my.apps.factset.com/viewer-fusion/?_doc_id=A3596626&_doc_date=2026-04-06&_doc_product=MNW",
"metadata": {
"source": "news",
"rms_document_type": "news",
"calendar_date": "2026-04-06T17:09:34.000Z",
"document_category": "news",
"stock_ids": [
"BBG001S5P3W6"
],
"tickers": [
"BEN"
]
}
}
]
}
}Retrieves the citation references (sources) used to generate a briefing delivery. Briefing email content embeds inline citations
[N] that point into this list via citation_idx.
References become available once the delivery status is sent. Call Get Delivery Detail first to confirm status and to grab the chat_session_id (required for building RMS viewer URLs).