List prepared filings, latest due date first
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
limit?integerPage size, 1–100
1 <= value <= 10020cursor?stringnext_cursor of the previous page
1 <= length <= 200type?string"bollo""withholdings""vat_payment""lipe""vat_return""redditi_pf"status?string"ready""needs_review""changes_requested""approved""skipped""filed""paid"Getbeel-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*stringdata*array<>has_more*booleannext_cursor*string|nullcurl -X GET 'https://www.getbeel.com/api/v1/filings'{ "object": "list", "data": [ { "id": "fil_3f2a…", "object": "filing", "type": "bollo", "period": "string", "status": "ready", "approved_at": "2019-08-24T14:15:22Z", "approved_by": "string", "skip_reason": "string", "filed_reference": "string", "extension": { "source_title": "string", "source_url": "string" }, "file_spec": { "id": "lipe:IVP18", "file": "lipe_xml", "name": "string", "version": "IVP18 (schema Versione 1.0)", "approved_by": "Provv. AdE prot. 125654 of 14 March 2024", "source_url": "string", "official_format": true, "tax_year": -9007199254740991, "other_tax_year": true, "provisional": true }, "due_date": "2026-10-29", "amount": "122.00", "currency": "EUR", "f24_lines": [ { "section": "erario", "tax_code": "2523", "reference_month": "string", "reference_year": "2026", "amount": "122.00" } ], "details": { "invoices": [ { "id": "string", "number": "string", "date": "2026-10-29", "list": "A" } ], "pending_invoices": [ { "id": "string", "number": "string", "date": "2026-10-29" } ], "invoices_without_bollo_flag": -9007199254740991, "bollo_threshold_confirmed": true, "deferral": { "pay_by": "september_30" }, "settlement": { "id": "string", "lipe": { "operations_active": "122.00", "operations_passive": "122.00", "vat_due": "122.00", "vat_deducted": "122.00", "vat_balance_debit": "122.00", "vat_balance_credit": "122.00", "previous_debt": "122.00", "previous_credit": "122.00", "annual_credit": "122.00", "car_payments": "122.00", "tax_credits": "122.00", "interest": "122.00", "advance": "122.00", "advance_method": -9007199254740991, "amount_due": "122.00", "amount_credit": "122.00" }, "notes": [ "string" ] }, "lipe": { "year": -9007199254740991, "quarter": -9007199254740991, "declarant": { "fiscal_code": "string", "role": -9007199254740991 }, "modules": [ { "month": -9007199254740991, "quarter": -9007199254740991, "lipe": { "operations_active": "122.00", "operations_passive": "122.00", "vat_due": "122.00", "vat_deducted": "122.00", "vat_balance_debit": "122.00", "vat_balance_credit": "122.00", "previous_debt": "122.00", "previous_credit": "122.00", "annual_credit": "122.00", "car_payments": "122.00", "tax_credits": "122.00", "interest": "122.00", "advance": "122.00", "advance_method": -9007199254740991, "amount_due": "122.00", "amount_credit": "122.00" } } ] }, "vat_return": { "year": -9007199254740991, "model": { "name": "IVA 2026", "tax_year": -9007199254740991, "approved_by": "string", "instructions_url": "string", "technical_specs": "string" }, "lines": [ { "quadro": "VE", "row": "VE23", "field": -9007199254740991, "code": "VE023001", "label": "string", "amount": -9007199254740991 } ], "balance": { "to_pay": -9007199254740991, "credit": -9007199254740991, "tax_code": "6099" }, "volume_d_affari": -9007199254740991, "periods": [ { "period": "string", "settlement_saved": true, "amount_to_pay": 0, "advance": 0, "paid": 0 } ], "issues": [ { "code": "string", "message": "string", "items": [ "string" ], "taxable": 0, "vat": 0 } ], "checks": [ { "rule": "string", "ok": true } ] }, "redditi_pf": { "year": -9007199254740991, "entity": "forfettario", "model": "Redditi PF 2026", "lines": [ { "quadro": "LM", "rigo": "string", "key": "string", "label": "string", "amount": "122.00" } ], "payments": [ { "property1": null, "property2": null } ], "balance_to_pay": 0, "warnings": [ "string" ], "needs_review": true }, "withholdings": [ { "id": "string", "recipient_name": "string", "document_number": "string", "paid_on": "2026-10-29", "withheld_amount": "122.00" } ] }, "checks": { "xsd": { "schema": "string", "valid": true, "issues": [ { "message": "string", "line": -9007199254740991 } ] }, "ade_control_software": "not_run" }, "needs_review": true, "receipt": { "uploaded_at": "2019-08-24T14:15:22Z" }, "completed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "next_steps": { "file_url": "string", "deep_link": { "url": "string", "label": "string" }, "other_links": [ { "url": "string", "label": "string" } ], "copy_values": [ { "key": "string", "label": "string", "value": "string" } ], "drafts": [ { "id": "bank", "subject": "string", "body": "string" } ], "steps": [ "string" ] } } ], "has_more": true, "next_cursor": "string"}ZIP for the accountant (XML, prima nota, VAT registers) GET
Everything an accountant imports for a year, quarter or month: the FatturaPA XML files of issued invoices (as sent to SDI), of received invoices (as received, or the attached file) and of the autofatture getbeel sent; prima-nota-iva.csv (one line per document and VAT rate or natura, with the XML file name); the VAT registers of each settlement period (CSV); bank movements (CSV); and LEGGIMI.txt listing any file that could not be read. Accounting packages (TeamSystem, Zucchetti, Profis and others) import the XML files with their e-invoice import; no vendor-specific layout is produced. CSV: semicolon, decimal comma, UTF-8. Italian companies only. Needs the invoices:read, received_invoices:read and bank:read scopes too. 422 too_many_documents when the period is too large for one file: ask for a quarter or a month.
Prepare a filing (F24, LIPE or VAT return data) POST
Prepares a filing for a period, or recomputes it while it is not paid or filed: bollo for a closed quarter (amount computed from the issued invoices; 422 nothing_due when no invoice needs it), withholdings for a month (the ritenute of the fees recorded in /withholdings and paid in that month, codice 1040; or send amount for fees outside getbeel; 422 nothing_due when none; the receipt locks the fees it paid), vat_payment for a closed month or quarter (saves the liquidazione computed from the VAT registers and returns its F24; 422 nothing_due, with the liquidazione saved and an unpaid F24 of the period deleted, for a credit, for up to €100 carried forward and for Q4 of quarterly payers; 409 filing_completed once the F24 is paid or the LIPE of the quarter is filed), lipe for a closed quarter (the XML of the Comunicazione liquidazioni periodiche IVA from the saved liquidazioni; 400 settlements_missing until they are saved; companies send declarant_fiscal_code; the file is checked against the official IVP18 XSD, reported in checks.xsd), vat_return for a closed year (period 2026: the data sheet of the Dichiarazione IVA, quadri VE, VF, VJ, VL and VX in whole euros, from the registers of every settlement period, the saved liquidazioni and the VAT F24 marked paid, with issues to check; previous_year_credit fills VL25; amount is the VX1 balance, F24 6099; not the telematic file). checks.ade_control_software is always not_run: the AdE control software is a desktop program the client runs. Returns next_steps (file, AdE page, values to copy, email drafts). Nothing is paid, signed or sent. Webhook filing.ready. Live keys only (403 livemode_required). Preparing is free: the filing is charged once, when it is paid or filed.