GetMyInvoices

GetMyInvoices (operated by fino data services GmbH, Kassel) automatically collects invoices and documents from thousands of online portals and mailboxes. This connector wraps the v3 Accounts API at https://api.getmyinvoices.com/accounts/v3.

Authentication

Generate an API key in the GetMyInvoices web app via the top-right menu → 'API access'. Set it as GETMYINVOICES_API_KEY. The connector sends it in the X-API-KEY header on every request. (Note: the older v1/v2 Go/PHP SDKs use a POST body api_key — that is NOT v3; v3 uses the header.)

Core concepts

• Documents (/documents) — the single resource for every document, including invoices, discriminated by documentType (e.g. INCOMING_INVOICE, SALES_INVOICE, RECEIPT, CREDIT_NOTE, PAYROLL). Use documentTypeFilter to narrow.
• Companies (/companies) — in GetMyInvoices terminology these are suppliers / online portals the documents come from.
• Attachments — extra files linked to a document under /documents/{documentUid}/attachments.

Pagination (documents only)

GET /documents is paginated with perPage (default 500) and pageNumber (default 1). The response envelope carries totalCount, maxPages, offset and the records array. Iterate pageNumber up to maxPages. GET /companies returns a plain array with no pagination.

Incremental sync & file content

• Use updatedOrNewSinceFilter=YYYY-MM-DD to fetch only documents created or modified since a date — ideal for syncing.
• To get the actual file bytes, call getmyinvoices_get_document (it returns fileContent as base64, plus meta_data and OCR readableContent). Set includeDocument=false when you only need metadata.

Rate limits

The API enforces per-minute and per-hour limits and returns X-RateLimit-Remaining-* headers plus Retry-After on HTTP 429 — respect those values and back off.