Skip to main content
GET
/
list
/
sources
Get Sources
curl --request GET \
  --url https://api.usecortex.ai/list/sources \
  --header 'Authorization: Bearer <token>'
{
  "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.

​
Sample Request

curl --request GET \
  --url 'https://api.usecortex.ai/list/sources?tenant_id=tenant_1234&sub_tenant_id=sub_tenant_4567' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
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

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
tenant_id
string
required

Unique identifier for the tenant/organization

Example:

"tenant_1234"

​
sub_tenant_id
string
default:""

Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.

Example:

"sub_tenant_4567"

Response

Successful Response

​
sources
Sources · array
required

List of source documents retrieved

​
success
boolean
default:true

Indicates whether the request was successful

Example:

true

​
message
string
default:Sources retrieved successfully

Response message describing the operation result

⌘I