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.
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.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
month?string^\d{4}-(0[1-9]|1[0-2])$folder?stringGetbeel-Company?stringAct 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.
uuidOK
application/json- response
object*stringmonth*string|nullfolder*string|nullfolders*array<>files*array<>curl -X GET 'https://www.getbeel.com/api/v1/drive'{ "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" } ]}Send an autofattura to SDI POST
Sends a generated autofattura to SDI, exactly like the Send to SDI button: the XML must be generated, and the send is paid from the prepaid balance at the SDI send price (402 insufficient_balance when it does not cover it). It is queued and returns the autofattura with sdi.status = queued; read it again for the SDI answer. Safe to repeat: a second call never sends or charges again (409 autofattura_already_queued or autofattura_already_sent). A corrected resend after an SDI rejection is not charged again. Live keys only.
Upload a document to the Drive POST
Uploads a document into a folder that takes uploads (writable true in GET /drive: a month, documents or a custom folder; a month folder is created if missing), by public https file_url or file_base64. PDF, PNG, JPEG, DOC or DOCX, up to 25 MB, the type read from the content (413 payload_too_large, 415 unsupported_file_type). It is only stored: to have the AI read a supplier invoice, use POST /received-invoices/uploads. Live keys only.