Factuarea APIDevelopers
Support
Open app

List all absence requests

List your company’s absence requests with cursor-based pagination.

Supports filtering by employee_id (UUID v7), absence_type_id (UUID v7), status (pending/approved/rejected/cancelled) and by date range (from/to, YYYY-MM-DD).

GET
/absence-requests

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

employee_id?|

Employee ID (UUID v7) to filter requests by.

Formatuuid
absence_type_id?|

Absence type ID (UUID v7) to filter requests by.

Formatuuid
status?|

Lifecycle status to filter by (pending/approved/rejected/cancelled).

Value in"pending" | "approved" | "rejected" | "cancelled" | null
from?|

Start date (Y-m-d) to filter the request range by.

Formatdate
to?|

End date (Y-m-d) to filter the request range by.

Formatdate
limit?integer

Number of objects to return. Integer between 1 and 100. Defaults to 25.

Default25
Range1 <= value <= 100
starting_after?string

Cursor for forward pagination. Use the uuid of the last object on the previous page.

Formatuuid
ending_before?string

Cursor for backward pagination. Use the uuid of the first object on the current page.

Formatuuid

Headers

Factuarea-Version?string

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.

Formatdate
X-Active-Profile?string

Operate on behalf of a child company (gestoría master key): pass its public id (UUID v7) and the request runs against that child's data without changing the key's scope, tier or environment (omit to use the key's own company). Invalid UUID → 400 parameter_invalid_uuid; unknown or non-owned id → 404 profile_not_found. See the Acting on behalf guide.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

Previous/v1/absence-balances/{absence_balance}
GET

Retrieve an absence balance

Retrieve a single absence balance by its id (UUID v7), including its accrued, carried-over, consumed and available days for the employee, absence type and year. A balance belonging to another company returns 404 absence_balance_not_found (anti-enumeration).

Next/v1/absence-requests
POST

Create an absence request

Create an absence request for the authenticated company (resolved from the API key, never from the payload). employee_id (UUID v7) is required — an API key acts as a system, so the target employee must be given. absence_type_id (UUID v7) and the start_date/end_date range (YYYY-MM-DD, end on or after start) are required; note is optional. The requested amount is computed in working days minus the applicable public holidays. If the absence type does not require approval it is auto-approved and consumes the balance. Returns the created request with its generated id (UUID v7).