Skip to Content
HelvetlyDocs
API referenceDocuments

Get a document's metadata

Needs a token with the read:documents scope (or write:documents). Authentication

Try in Playground sends a real request to app.helvetly.com with a token you paste. It stays in this browser tab only (session storage) and goes to no one else.

GET
/api/v1/documents/{id}

One document's metadata.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A personal API token, hvt_…, with scopes such as read:* or write:invoices

Path Parameters

id*string

The record's id.

Response Body

OK

application/json
  1. response
data*

A document's metadata. The bytes come from download_document and get_document_content.

Example Request
curl -X GET 'https://app.helvetly.com/api/v1/documents/string'
Example Response
{  "data": {    "id": "string",    "name": "string",    "folder_id": "string",    "folder": {      "id": "string",      "name": "string"    },    "size": 0,    "content_type": "string",    "kind": "pdf",    "previewable": true,    "sha256": "string",    "links": [      {        "type": "string",        "id": "string",        "label": "string",        "retains": true      }    ],    "retained_until": "2019-08-24",    "uploaded_by": {      "id": "string",      "name": "string"    },    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z",    "deleted_at": "2019-08-24T14:15:22Z",    "deleted_by": {      "id": "string",      "name": "string"    },    "purge_at": "2019-08-24T14:15:22Z"  }}