curl --request POST \
  --url https://api.filexpress.app/api/external/v1/hr/attendances \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "records": [
    {
      "document_number": "01234567-8",
      "date": "2026-10-01",
      "check_in": "08:02",
      "check_out": "17:05"
    },
    {
      "employee_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
      "date": "2026-10-01",
      "check_in": "07:55",
      "check_out": "18:30",
      "notes": "Cierre de mes"
    },
    {
      "document_number": "98765432-1",
      "date": "2026-10-01",
      "check_in": "08:10"
    },
    {
      "document_number": "45678912-3",
      "date": "2026-10-01",
      "check_in_at": "2026-10-01 22:00",
      "check_out_at": "2026-10-02 06:05"
    },
    {
      "document_number": "11223344-5",
      "date": "2026-10-01",
      "punches": [
        {
          "type": "in",
          "at": "2026-10-01 08:00"
        },
        {
          "type": "out",
          "at": "2026-10-01 12:00"
        },
        {
          "type": "in",
          "at": "2026-10-01 13:00"
        },
        {
          "type": "out",
          "at": "2026-10-01 17:02"
        }
      ]
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    records: [
      {
        document_number: '01234567-8',
        date: '2026-10-01',
        check_in: '08:02',
        check_out: '17:05'
      },
      {
        employee_id: '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
        date: '2026-10-01',
        check_in: '07:55',
        check_out: '18:30',
        notes: 'Cierre de mes'
      },
      {document_number: '98765432-1', date: '2026-10-01', check_in: '08:10'},
      {
        document_number: '45678912-3',
        date: '2026-10-01',
        check_in_at: '2026-10-01 22:00',
        check_out_at: '2026-10-02 06:05'
      },
      {
        document_number: '11223344-5',
        date: '2026-10-01',
        punches: [
          {type: 'in', at: '2026-10-01 08:00'},
          {type: 'out', at: '2026-10-01 12:00'},
          {type: 'in', at: '2026-10-01 13:00'},
          {type: 'out', at: '2026-10-01 17:02'}
        ]
      }
    ]
  })
};

fetch('https://api.filexpress.app/api/external/v1/hr/attendances', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.filexpress.app/api/external/v1/hr/attendances"

payload = { "records": [
        {
            "document_number": "01234567-8",
            "date": "2026-10-01",
            "check_in": "08:02",
            "check_out": "17:05"
        },
        {
            "employee_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
            "date": "2026-10-01",
            "check_in": "07:55",
            "check_out": "18:30",
            "notes": "Cierre de mes"
        },
        {
            "document_number": "98765432-1",
            "date": "2026-10-01",
            "check_in": "08:10"
        },
        {
            "document_number": "45678912-3",
            "date": "2026-10-01",
            "check_in_at": "2026-10-01 22:00",
            "check_out_at": "2026-10-02 06:05"
        },
        {
            "document_number": "11223344-5",
            "date": "2026-10-01",
            "punches": [
                {
                    "type": "in",
                    "at": "2026-10-01 08:00"
                },
                {
                    "type": "out",
                    "at": "2026-10-01 12:00"
                },
                {
                    "type": "in",
                    "at": "2026-10-01 13:00"
                },
                {
                    "type": "out",
                    "at": "2026-10-01 17:02"
                }
            ]
        }
    ] }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.filexpress.app/api/external/v1/hr/attendances",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'records' => [
        [
                'document_number' => '01234567-8',
                'date' => '2026-10-01',
                'check_in' => '08:02',
                'check_out' => '17:05'
        ],
        [
                'employee_id' => '9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11',
                'date' => '2026-10-01',
                'check_in' => '07:55',
                'check_out' => '18:30',
                'notes' => 'Cierre de mes'
        ],
        [
                'document_number' => '98765432-1',
                'date' => '2026-10-01',
                'check_in' => '08:10'
        ],
        [
                'document_number' => '45678912-3',
                'date' => '2026-10-01',
                'check_in_at' => '2026-10-01 22:00',
                'check_out_at' => '2026-10-02 06:05'
        ],
        [
                'document_number' => '11223344-5',
                'date' => '2026-10-01',
                'punches' => [
                                [
                                                                'type' => 'in',
                                                                'at' => '2026-10-01 08:00'
                                ],
                                [
                                                                'type' => 'out',
                                                                'at' => '2026-10-01 12:00'
                                ],
                                [
                                                                'type' => 'in',
                                                                'at' => '2026-10-01 13:00'
                                ],
                                [
                                                                'type' => 'out',
                                                                'at' => '2026-10-01 17:02'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "status": true,
  "data": {
    "created": 2,
    "updated": 0,
    "failed": 1,
    "results": [
      {
        "index": 0,
        "status": "created",
        "id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
        "employee_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11"
      },
      {
        "index": 1,
        "status": "created",
        "id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
        "employee_id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11"
      },
      {
        "index": 2,
        "status": "error",
        "message": "Employee not found (send a valid employee_id or document_number)."
      }
    ]
  }
}

{
  "status": false,
  "message": "Invalid API Key."
}

{
  "status": false,
  "message": "This integration does not have the 'hr.employees' permission.",
  "required_scope": "hr.employees"
}

{
  "status": false,
  "message": "Validation errors",
  "errors": {
    "start_date": [
      "The start date field is required."
    ]
  }
}

{
  "status": false,
  "message": "Rate limit exceeded. Please try again later.",
  "rate_limit": 100
}