Skip to main content
GET
/
v1
/
documents
/
batch_presigned_urls
Batch Presigned URLs
curl --request GET \
  --url https://api.linqalpha.com/v1/documents/batch_presigned_urls \
  --header 'X-API-KEY: <api-key>'
{
  "error": null,
  "payload": {
    "documents": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "ticker": "AAPL",
        "doc_type": "filing",
        "doc_sub_type": "10-K",
        "name": "Q4 2024 Apple Inc.",
        "fiscal_date": "2024-12-31",
        "calendar_date": "2025-01-30",
        "published_at": "2025-01-30T16:00:00Z",
        "presigned_url": "https://linq-vertex-documents.s3.amazonaws.com/..."
      }
    ],
    "total_count": 42,
    "page": 1,
    "per_page": 20,
    "has_more": false,
    "skipped_count": 3
  }
}
Generate temporary presigned URLs for multiple documents in a single request. This is more efficient than calling the single-document endpoint repeatedly.

​
Quick Start

Basic Usage
curl --request GET \
  --url 'https://api.linqalpha.com/v1/documents/batch_presigned_urls?tickers=AAPL&per_page=20' \
  --header 'X-API-KEY: <api-key>'
Filter by Date Range
curl --request GET \
  --url 'https://api.linqalpha.com/v1/documents/batch_presigned_urls?tickers=AAPL&calendar_period[start_time][year]=2025&calendar_period[start_time][month]=1&calendar_period[end_time][year]=2025&calendar_period[end_time][month]=12' \
  --header 'X-API-KEY: <api-key>'
Multiple Tickers and Document Types
curl --request GET \
  --url 'https://api.linqalpha.com/v1/documents/batch_presigned_urls?tickers=AAPL&tickers=MSFT&doc_sub_type=10-K&doc_sub_type=10-Q&per_page=50' \
  --header 'X-API-KEY: <api-key>'
Presigned URLs expire after approximately 1 hour. Generate new URLs when needed.

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
tickers
string[]

Ticker symbol(s) to filter by. At least one ticker or stock_id is required. Use multiple tickers params for multiple tickers (e.g., ?tickers=AAPL&tickers=MSFT).

​
stock_ids
string[]

Stock ID(s) to filter by. Can be used instead of or together with tickers.

​
doc_type
string[]

Document type filter (e.g., filing, earnings_call)

​
doc_sub_type
string[]

Document sub-type filter (e.g., 10-K, 10-Q, annual_report, press_release)

​
fiscal_period
object

Fiscal period filter. Use nested object notation in the query string (e.g., fiscal_period[start_time][year]=2024&fiscal_period[start_time][quarter]=1).

​
calendar_period
object

Calendar period filter. Use nested object notation in the query string (e.g., calendar_period[start_time][year]=2025&calendar_period[start_time][month]=1).

​
page
integer
default:1

Page number (default: 1)

Required range: x >= 1
​
per_page
integer
default:20

Number of results per page (default: 20, max: 200)

Required range: 1 <= x <= 200

Response

Batch presigned URLs with document metadata

​
error
object
​
payload
object