GetbeelDocs

List a month or folder of the Drive

The folders and files of one month (month=2026-10: invoice files by invoice date, statements and uploads by upload date) or of one uploads folder (folder=contratti or 2026-10/contratti), newest first. Invoice files also need received_invoices:read and bank statements bank:read; without them they are left out. Both key modes.

GET
/drive

The folders and files of one month (month=2026-10: invoice files by invoice date, statements and uploads by upload date) or of one uploads folder (folder=contratti or 2026-10/contratti), newest first. Invoice files also need received_invoices:read and bank statements bank:read; without them they are left out. Both key modes.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

month?string
Match^\d{4}-(0[1-9]|1[0-2])$
folder?string

Header Parameters

Getbeel-Company?string

Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.

Formatuuid

Response Body

OK

application/json
  1. response
object*string
month*string|null
folder*string|null
folders*array<>
files*array<>
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/drive'
Example Response
{  "object": "drive",  "month": "string",  "folder": "string",  "folders": [    {      "object": "drive_folder",      "path": "string",      "name": "string",      "kind": "system",      "month": "string",      "file_count": -9007199254740991,      "total_size": -9007199254740991,      "updated_at": "string",      "writable": true    }  ],  "files": [    {      "object": "drive_file",      "id": "string",      "name": "string",      "kind": "invoice",      "folder": "string",      "mime_type": "string",      "size": -9007199254740991,      "created_at": "string",      "document_date": "string",      "month": "string",      "vendor_name": "string"    }  ]}