SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

Check a file sent to this service: ready, waiting for upload, or refused and why

GEThttps://app.softsolz.uk/api/v1/services/creative-studio/files/{file_id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

file_idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Response

Response Body

file_idstringPass this id to the service to use the file.
statusstringready means the file passed every check and can be used.
file_namestringCleaned file name.
kindstring | nullWhat the file turned out to be, read from its bytes.
mimestring | nullMedia type read from the bytes.
size_bytesintegerSize in bytes.
sha256string | nullHex SHA-256 of the file.
reject_codestring | nullWhy the file was refused, when status is rejected.
expires_atstring | nullWhen the file (or, before upload, the link) stops working.
created_atstringWhen it was created.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/creative-studio/files/{file_id} \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"file_id": "f0000000-0000-0000-0000-000000000001",
"status": "ready",
"file_name": "launch-deck.pptx",
"kind": "document",
"mime": "your-mime",
"size_bytes": 482133,
"sha256": "your-sha256",
"reject_code": null,
"expires_at": "2026-01-01T09:00:00.000Z",
"created_at": "2026-01-01T09:00:00.000Z"
}
}