Absence Requests

Create an absence request

Create an absence request for an employee; returns it with its generated id (UUID v7).

  • Required: employee_id, absence_type_id, and start_date/end_date (YYYY-MM-DD, end on or after start); note is optional.
  • The amount is working days minus public holidays.
  • A type that does not require approval is auto-approved and consumes the balance.
post/companies/{company}/absence-requests

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/absence-requests
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Headers

Idempotency-Keystring
Example:01928f10-7c0e-7c4a-9b7d-2f8a6e3c1d4b

Client-generated opaque key (up to 255 characters; UUID v7 recommended) that makes retries safe: the first response is cached and replayed for repeats without re-executing the mutation. Reusing a key with a different body returns 422 idempotency_key_reused; the values of secret fields (password, secret…) count as part of the body, so retrying with a corrected secret under the same key is a different request, never the replay of the earlier answer. See the Idempotency guide.

Factuarea-Versionstring date
Example:2026-06-01

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.

Request body

employee_idstring uuid required

Employee ID (UUID v7) requesting the absence.

absence_type_idstring uuid required

Requested absence type ID (UUID v7).

start_datestring date required

Absence start date, in Y-m-d.

end_datestring date required

Absence end date, in Y-m-d, equal to or after the start.

notestring nullable

Optional note for the request.

Response

Absence request created. The Location header contains the canonical URL of the new absence request.

Example response

{
  "data": {
    "id": "01933a32-e287-7193-9fa0-7a8b9c0d1e01",
    "object": "absence_request",
    "employee_id": "01933a1f-8c21-7b3d-9e4f-1a2b3c4d5e01",
    "absence_type_id": "01933a30-c065-7f71-9d8e-5e6f7a8b9c01",
    "absence_type_name": "Vacaciones",
    "color": "#2563EB",
    "status": "approved",
    "start_date": "2026-08-03",
    "end_date": "2026-08-14",
    "day_amount": "10.00",
    "measurement_unit": "days",
    "note": "Vacaciones de verano.",
    "reviewer_user_id": "01933a1f-8c21-7b3d-9e4f-1a2b3c4d5eaa",
    "review_note": "Aprobado.",
    "reviewed_at": "2026-06-20T10:15:00Z",
    "created_at": "2026-06-18T12:00:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.