Skip to main content

​
GET /resources/wrappers/files/

Retrieve detailed information about a previously uploaded file, including its validation status, preview data, and metadata.

​
Authentication

No authentication required.

​
Path Parameters

​
file_id
string
required
The unique identifier of the uploaded file (returned from the upload endpoint).

​
Response

​
file_id
string
required
Unique identifier for the uploaded file.
​
filename
string
required
Original filename as provided during upload.
​
file_size
integer
required
File size in bytes.
​
preview_data
string
Sample of the file content (first 5 rows) for preview purposes.
​
validation_status
string
required
File validation status. Possible values:
  • valid - File passed all validation checks
  • invalid - File failed validation
  • pending - Validation in progress
​
validation_errors
array
List of validation error messages if the file is invalid. Only present when validation_status is invalid.
​
item
string
Error message describing the validation failure.
​
message
string
required
Human-readable message describing the result.

​
Example Request

curl -X GET https://api.example.com/resources/wrappers/files/a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6

​
Example Response

​
Success

{
  "file_id": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
  "filename": "sales_data.csv",
  "file_size": 245760,
  "preview_data": "timestamp          value\n2024-01-01 00:00:00  100.5\n2024-01-01 01:00:00  102.3\n2024-01-01 02:00:00  98.7\n2024-01-01 03:00:00  105.2\n2024-01-01 04:00:00  99.8",
  "validation_status": "valid",
  "validation_errors": null,
  "message": "File information retrieved successfully"
}

​
Error Responses

​
404 Not Found

File not found: 
{
  "detail": "File not found"
}

​
503 Service Unavailable

Database unavailable: 
{
  "detail": "Database unavailable"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us