Skip to main content
POST
/
list
/
sources_by_id
Get Source By Id
curl --request POST \
  --url https://api.usecortex.ai/list/sources_by_id \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tenant_id": "tenant_1234",
  "source_ids": [
    "CortexDoc1234",
    "CortexDoc4567"
  ],
  "sub_tenant_id": "sub_tenant_4567"
}'
{
  "sources": [
    {
      "id": "<id>",
      "title": "<title>",
      "type": "<type>",
      "timestamp": "<timestamp>",
      "description": "<description>",
      "document_metadata": {
        "quarter": 3,
        "year": 2023
      },
      "tenant_metadata": {
        "confidentiality": "high"
      }
    }
  ],
  "success": true,
  "message": "Sources retrieved successfully"
}
Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

​
Examples

  • API Request
  • TypeScript
  • Python (Sync)
curl --request POST \
  --url https://api.usecortex.ai/list/sources_by_id \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tenant_id": "tenant_1234",
  "source_ids": [],
  "sub_tenant_id": "sub_tenant_4567"
}'

​
Overview

Retrieve specific sources by their IDs. Use this API to fetch one or more sources by providing their unique identifiers. This is useful when you need detailed information about specific documents or content you’ve previously uploaded.

​
Example Request

{
  "tenant_id": "tenant_456",
  "sub_tenant_id": "subtenant_123",
  "source_ids": ["doc_123", "doc_456"]
}

​
Example Response

{
  "sources": [
    {
      "id": "CortexDoccf0f1ccee4864c679bad5678bb1c515a1757402245",
      "title": "ai-2027.pdf",
      "type": "file",
      "timestamp": "1757402409.7277222",
      "description": "### **AI Futures** **Project** # **AI** **2027** ### **AI Futures** ### **Project** ## **`Daniel Kokotajlo`** **`Scott Alexander`** **`Thomas Larsen`** **`Eli Lifland`** **`Romeo Dean`** ``` Originally published on April 3rd 2025 on AI-2027.com ``` ``` Design by Lightcone Infrastructure ``` ## **AI 2027** We predict that the impact of superhuman AI",
      "document_metadata": {},
      "tenant_metadata": {}
    }
  ],
  "success": true,
  "message": "Successfully fetched sources"
}

​
Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

​
Authorization
string
header
required

Body

application/json
​
tenant_id
string
required
Example:
​
source_ids
string[]
required
Example:
​
sub_tenant_id
string
default:""
Example:

Response

​
sources
Sources · array
required
​
success
boolean
default:true
Example:
​
message
string
default:Sources retrieved successfully