Get Buyer File Download Links

curl --request GET \
  --url https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links', 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://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links",
  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://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links")

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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contentType": "<string>",
  "originalLink": "<string>",
  "originalName": "<string>",
  "type": "Rfp",
  "originalSizeBytes": 123,
  "markdownLink": "<string>"
}

REST API

Get Buyer File Download Links

Returns 1-hour signed download URLs for a single buyer file: the original file (in its native format — PDF, DOCX, VTT, etc.) and the parsed-markdown rendering.

Use fileId from researchBuyerFiles (per-file IDs in buyerFiles[].id). Prefer viewFileContents for token-bounded markdown; use this tool only when you need the raw bytes (e.g., to render a PDF for the user, hand off to a parser, or attach the original to an email).

WARNING — both files may be very large. Original PDFs are commonly multi-megabyte; parsed markdown is usually smaller but neither size is bounded. Do NOT fetch either link and inline its contents into your context. For text, use viewFileContents (token-bounded). To show a file to the user, hand them the URL directly.

Response fields:

originalLink — 1h signed URL to the original file. May be very large; see the warning above.
markdownLink — 1h signed URL to the parsed-markdown rendering, or null if the file is not yet processed (e.g., status != Processed). May also be very large; see the warning above.
originalSizeBytes — size of the original blob in bytes. May be null for older files. Use this to decide whether to fetch.
contentType — MIME type of the original (e.g., application/pdf, text/vtt).
type — buyer-file classification (Rfp, Contract, PurchaseOrder, BoardMeeting, StrategicPlan, Other, …); null if not yet detected.
originalName — original file name as uploaded or scraped. For scraped sources this is often a URL-encoded source path (e.g., https_www_youtube_com_watch_v_xyz.vtt) — do NOT surface it to the user as-is.

Links expire in 1 hour. Returns 404 if no buyer file with the given id exists.

GET

api

external

buyer

file

{fileId}

download-links

Get Buyer File Download Links

curl --request GET \
  --url https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links', 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://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links",
  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://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://dashboard.starbridge.ai/api/external/buyer/file/{fileId}/download-links")

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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contentType": "<string>",
  "originalLink": "<string>",
  "originalName": "<string>",
  "type": "Rfp",
  "originalSizeBytes": 123,
  "markdownLink": "<string>"
}

Authorizations

Authorization

string

header

required

HTTP Bearer Authentication

Path Parameters

fileId

string<uuid>

required

Buyer file ID, from researchBuyerFiles.

Response

Signed download links and metadata for the requested buyer file.

string<uuid>

required

Unique identifier of the buyer file.

contentType

string

required

MIME type of the original file (e.g., application/pdf, text/vtt).

originalLink

string

required

1-hour signed URL to the original file. WARNING: this file may be very large (multi-megabyte PDFs are common) and is not size-bounded. Do NOT fetch and inline its contents into your context — use viewFileContents for token-bounded text, or hand the URL to the user.

originalName

string | null

Original file name as uploaded or scraped. For scraped sources this is often a URL-encoded source path (e.g., https_www_youtube_com_watch_v_xyz.vtt) — do NOT surface it to the user as-is.

type

enum<string> | null

Buyer-file classification (Rfp, Contract, PurchaseOrder, BoardMeeting, StrategicPlan, Other, …). Null if the type has not been detected yet.

Available options:

Rfp,

RfpProposal,

Contract,

PurchaseOrder,

VendorList,

BoardMeeting,

BoardMeetingAgenda,

BoardMeetingAgendaPacket,

StrategicPlan,

CapitalImprovementPlan,

AnnualFinancialReport,

ProposedBudget,

Budget,

BudgetAmendment,

CurriculumAdoptionSchedule,

Other

originalSizeBytes

integer | null

Size of the original file in bytes. May be null for older files where size was not recorded. Use this to decide whether the file is too large to fetch.

markdownLink

string | null

1-hour signed URL to the parsed-markdown rendering of the file, or null if the file is not yet processed. WARNING: markdown is typically smaller than the original but is also not size-bounded and may itself be very large. Do NOT fetch and inline its contents into your context — use viewFileContents for token-bounded text, or hand the URL to the user.

⌘I