/tasks
curl --request GET \
--url https://api.linkup.so/v1/tasks \
--header 'Authorization: Bearer <token>'{
"metadata": {
"page": 123,
"pageSize": 123,
"total": 123,
"totalPages": 123
},
"data": [
{
"createdAt": "2026-01-01T00:00:00.000Z",
"error": "<string>",
"id": "01234-abcd-56789",
"status": "completed",
"updatedAt": "2026-01-01T00:00:00.000Z",
"input": {
"q": "What is Microsoft's 2024 revenue?",
"excludeDomains": [
"wikipedia.org"
],
"fromDate": "2025-01-01",
"includeDomains": [
"microsoft.com",
"agolution.com"
],
"structuredOutputSchema": null,
"toDate": "2025-01-01",
"includeImages": false,
"includeInlineCitations": false,
"includeSources": false,
"maxResults": 5
},
"output": {
"answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
"sources": [
{
"name": "Microsoft 2024 Annual Report",
"snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
"url": "https://www.microsoft.com/investor/reports/ar24/index.html"
}
]
},
"type": "<string>"
}
],
"quota": {
"inFlight": 4503599627370495,
"limit": 123
}
}Tasks
/tasks
The GET /tasks method, without a task identifier, lists all created tasks for the authenticated organization, with pagination.
GET
/
v1
/
tasks
/tasks
curl --request GET \
--url https://api.linkup.so/v1/tasks \
--header 'Authorization: Bearer <token>'{
"metadata": {
"page": 123,
"pageSize": 123,
"total": 123,
"totalPages": 123
},
"data": [
{
"createdAt": "2026-01-01T00:00:00.000Z",
"error": "<string>",
"id": "01234-abcd-56789",
"status": "completed",
"updatedAt": "2026-01-01T00:00:00.000Z",
"input": {
"q": "What is Microsoft's 2024 revenue?",
"excludeDomains": [
"wikipedia.org"
],
"fromDate": "2025-01-01",
"includeDomains": [
"microsoft.com",
"agolution.com"
],
"structuredOutputSchema": null,
"toDate": "2025-01-01",
"includeImages": false,
"includeInlineCitations": false,
"includeSources": false,
"maxResults": 5
},
"output": {
"answer": "Microsoft's revenue for fiscal year 2024 was $245.1 billion, reflecting a 16% increase from the previous year.",
"sources": [
{
"name": "Microsoft 2024 Annual Report",
"snippet": "Highlights from fiscal year 2024 compared with fiscal year 2023 included: Microsoft Cloud revenue increased 23% to $137.4 billion.",
"url": "https://www.microsoft.com/investor/reports/ar24/index.html"
}
]
},
"type": "<string>"
}
],
"quota": {
"inFlight": 4503599627370495,
"limit": 123
}
}Documentation Index
Fetch the complete documentation index at: https://docs.linkup.so/llms.txt
Use this file to discover all available pages before exploring further.
Get your API key
Create a Linkup account for free to get your API key.
This endpoint only retrieves data from existing tasks. It does not create a new task.
To create a new task, use
POST /tasks.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Available options:
fetch, research, search Available options:
completed, failed, pending, processing Required range:
x >= 1Required range:
1 <= x <= 100Available options:
createdAt, updatedAt Available options:
asc, desc ⌘I