Skip to main content
All operations require authentication using Bearer tokens. Make sure you have your API credentials ready.

​
List All Data Sources

Retrieve a paginated list of all your uploaded data sources. 
curl -X GET "https://secure-api.getclaro.ai/api/v2/datasources?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get Data Source Details

Retrieve detailed information about a specific data source. 
curl -X GET "https://secure-api.getclaro.ai/api/v2/datasources/$DATASOURCE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Get Data Source Data

Retrieve paginated data from a specific data source. 
curl -X GET "https://secure-api.getclaro.ai/api/v2/datasources/$DATASOURCE_ID/data?page=1&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Delete Data Source

Permanently delete a data source and all its associated data. 
curl -X DELETE "https://secure-api.getclaro.ai/api/v2/datasources/$DATASOURCE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Generate Download URL

Generate a signed URL to download the original data source file. 
curl -X POST "https://secure-api.getclaro.ai/api/v2/datasources/$DATASOURCE_ID/download" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expiresIn": 3600}'

​
Query Parameters

​
List Data Sources

  • page (integer): Page number (default: 1)
  • limit (integer): Items per page (default: 20, max: 100)
  • status (string): Filter by status (processing, completed, failed)
  • contentType (string): Filter by content type (text/csv, application/pdf, etc.)

​
Get Data Source Data

  • page (integer): Page number (default: 1)
  • limit (integer): Rows per page (default: 50, max: 1000)
  • sort (string): Sort by column name (default: original order)
  • order (string): Sort order (asc or desc, default: asc)
  • filter (string): Filter expression (e.g., price > 100)

​
Generate Download URL

  • expiresIn (integer): URL expiration time in seconds (default: 3600, max: 86400)

​
Error Codes

CodeDescription
UNAUTHORIZEDAuthentication required
DATASOURCE_NOT_FOUNDData source doesn’t exist
PROCESSING_IN_PROGRESSData source still being processed
INVALID_PARAMETERSInvalid query parameters
ACCESS_DENIEDInsufficient permissions

​
Next Steps

Upload Data Source

Upload new data sources for cleaning and organization

Create Dataset

Create datasets from your cleaned data sources