Preview the employee seat charge
Preview the prorated per-seat charge for activating or hiring employees, without charging.
- Send count (1 to 1000) or employee_ids (UUID v7); already covered employees cost 0.
- Amounts are 2-decimal euro strings; 403 billing_managed_by_provider when the provider manages billing.
Request
- Base URL: https://api.factuarea.com/v1
- URL: https://api.factuarea.com/v1/accounts/{account}/employee-seats/preview
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Path parameters
Public identifier (UUID v7) of your account. Get it from GET /v1/me (data.account.id).
Query parameters
Number of employees that would be activated in bulk (at least 1, default 1).
Public identifiers (UUID v7) of the employees to preview; omit it to preview count employees.
Headers
Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.
Response
Example response
{
"data": {
"object": "employee_seat_charge_preview",
"amount": "0.75",
"tax_amount": "0.16",
"total": "0.91",
"tax_rate": 21,
"currency": "EUR",
"next_invoice_date": "2026-08-01T09:12:00+00:00",
"recurring_quantity": 5,
"recurring_base_cents": 750,
"recurring_total_cents": 908,
"seats_billable": true
}
}Changes
No recorded changes to this operation across all 1 revision of this API.