Extras

Read-only query endpoints for retrieving attendance records, working hours, personnel lists, and reference data.

For all date-range endpoints the interval between from and to must not exceed one month.

---

Ver Marcas

GET https://api.mitrabajo.uy/ver-marcas

Returns daily attendance records (clock-in / break / return / clock-out) for the given date range.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
from	string	Yes	Start date — format YYYY-MM-DD
to	string	Yes	End date — format YYYY-MM-DD. Max one month after from
person	string	No	Filter by employee document number

Example

curl "https://api.mitrabajo.uy/ver-marcas?from=2026-07-01&to=2026-07-31" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "country": "UY",
    "ssn_num": "12345678",
    "name": "Juan García",
    "fecha": "2026-07-01",
    "entrada":  "2026-07-01 08:02:00",
    "descanso": "2026-07-01 12:00:00",
    "retorno":  "2026-07-01 13:05:00",
    "salida":   "2026-07-01 17:00:00"
  },
  {
    "country": "UY",
    "ssn_num": "12345678",
    "name": "Juan García",
    "fecha": "2026-07-02",
    "entrada":  "2026-07-02 07:58:00",
    "descanso": null,
    "retorno":  null,
    "salida":   "2026-07-02 16:55:00"
  }
]

---

Ver Horas

GET https://api.mitrabajo.uy/ver-horas

Returns daily working hours broken down by type (normal, night, overtime) for the given date range.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
from	string	Yes	Start date — format YYYY-MM-DD
to	string	Yes	End date — format YYYY-MM-DD. Max one month after from
person	string	No	Filter by employee document number

Example

curl "https://api.mitrabajo.uy/ver-horas?from=2026-07-01&to=2026-07-31" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "country": "UY",
    "employee_number": "EMP001",
    "ssn_num": "12345678",
    "name": "Juan García",
    "fecha": "2026-07-01",
    "horas_normales": "08:00:00",
    "horas_nocturnas": "00:00:00",
    "horas_extras_normales": "00:30:00",
    "horas_extras_nocturnas": "00:00:00",
    "minutos_descanso": 60,
    "horas_normales_dec": 8.0,
    "horas_nocturnas_dec": 0.0,
    "horas_extras_normales_dec": 0.5,
    "horas_extras_nocturnas_dec": 0.0
  }
]

---

Ver Horas Mensuales

GET https://api.mitrabajo.uy/ver-horas-mensuales

Returns monthly totals of working hours per employee for the given date range.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
from	string	Yes	Start date — format YYYY-MM-DD
to	string	Yes	End date — format YYYY-MM-DD. Max one month after from
person	string	No	Filter by employee document number

Example

curl "https://api.mitrabajo.uy/ver-horas-mensuales?from=2026-07-01&to=2026-07-31" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "country": "UY",
    "employee_number": "EMP001",
    "ssn_num": "12345678",
    "name": "Juan García",
    "horas_normales_dec": 168.0,
    "horas_nocturnas_dec": 0.0,
    "horas_extras_normales_dec": 4.5,
    "horas_extras_nocturnas_dec": 0.0
  }
]

---

Horas Trabajadas

GET https://api.mitrabajo.uy/horas-trabajadas

Returns working hours for all employees on a specific date.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
date	string	Yes	The date to query — format YYYY-MM-DD

Example

curl "https://api.mitrabajo.uy/horas-trabajadas?date=2026-07-29" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "id": 101,
    "employee_number": "EMP001",
    "ssn_num": "12345678",
    "last_name": "García",
    "first_name": "Juan",
    "categoria": "Administrativo",
    "nombre": "Oficina Central",
    "fecha_desde": "2026-07-29",
    "HsNorm": 8.0,
    "HsNoc": 0.0,
    "HsExt": 0.5,
    "HsExtNoc": 0.0
  }
]

---

Marcas Persona Mes

GET https://api.mitrabajo.uy/marcas-persona-mes

Returns a detailed per-person, per-day attendance report including planned vs. actual entry and exit times.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
from	string	Yes	Start date — format YYYY-MM-DD
to	string	Yes	End date — format YYYY-MM-DD

Example

curl "https://api.mitrabajo.uy/marcas-persona-mes?from=2026-07-01&to=2026-07-31" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "fecha": "01/07/2026",
    "dia": "Wed",
    "entrada": "08:00",
    "salida": "17:00",
    "nombre_persona": "García Juan",
    "nombre_local": "42 Oficina Central",
    "employee_number": "EMP001",
    "minutos_descanso": 60,
    "entrada_real": "08:02",
    "salida_real": "17:00",
    "horas": "08:58",
    "ssn_num": "12345678",
    "Generadas": "08:00"
  }
]

---

Ver Novedades

GET https://api.mitrabajo.uy/ver-novedades

Returns task/novelty records assigned to employees within the given date range.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
from	string	Yes	Start date — format YYYY-MM-DD
to	string	Yes	End date — format YYYY-MM-DD. Max one month after from
person	string	No	Filter by employee document number

Example

curl "https://api.mitrabajo.uy/ver-novedades?from=2026-07-01&to=2026-07-31" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "fecha": "2026-07-15",
    "ssn_num": "12345678",
    "employee_number": "EMP001",
    "name": "Juan García",
    "id": 9,
    "novedad": "Licencia médica",
    "horas": "08:00:00"
  }
]

---

Funcionarios

GET https://api.mitrabajo.uy/funcionarios

Returns the list of active employees linked to your account. Optionally filter by country and document number.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
country	string	No	2-character country code
doc	string	No	Employee document number. Requires country to also be set

Example

curl "https://api.mitrabajo.uy/funcionarios" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  {
    "employee_id": "EMP001",
    "first_name": "Juan",
    "last_name": "García",
    "birthday": "1985-06-15",
    "gender": "Male",
    "identification_id": "12345678",
    "country": "UY",
    "country_dir": "UY",
    "address": "Calle Principal",
    "door_number": "100",
    "neighborhood": "Pocitos",
    "city": "Montevideo",
    "mobile_phone": "+598 9 123 4567",
    "joined_date": "2024-01-15",
    "fired_date": null,
    "cuenta_banco": null,
    "banco": null,
    "telefono_familia": null,
    "locomocion": null,
    "tiene_hijos": null,
    "proveedor": null
  }
]

---

Codigo Novedades

GET https://api.mitrabajo.uy/codigo-novedades

Returns the list of novelty/task codes configured for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/codigo-novedades \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  { "id": 1, "nombre": "Licencia médica" },
  { "id": 2, "nombre": "Vacaciones" },
  { "id": 3, "nombre": "Ausencia injustificada" }
]

---

Codigo Eventos Extras

GET https://api.mitrabajo.uy/codigo-eventos-extras

Returns the list of extra event type codes available for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/codigo-eventos-extras \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  { "id": 1, "nombre": "Pausa técnica" },
  { "id": 2, "nombre": "Reunión de equipo" }
]

---

Codigo Lugares

GET https://api.mitrabajo.uy/codigo-lugares

Returns workplaces with their external IDs — useful for mapping your system's IDs to MiTrabajo records.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/codigo-lugares \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  { "id_externo": 42, "nombre": "Oficina Central" },
  { "id_externo": 55, "nombre": "Sucursal Norte" }
]

---

Imagenes Adjuntas

GET https://api.mitrabajo.uy/imagenes-adjuntas

Returns the profile image of an employee as a Base64-encoded string.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

Parameters are passed as query string.

Parameter	Type	Required	Description
id	integer	Yes	Internal employee ID

Example

curl "https://api.mitrabajo.uy/imagenes-adjuntas?id=101" \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "code": 0,
  "data": [
    {
      "filename": "profile_image_101.jpeg",
      "tipo": "foto-perfil",
      "data": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

If no image is found:

{
  "code": 1,
  "filename": null,
  "data": null
}

---

Recibo Importar

POST https://api.mitrabajo.uy/recibo-importar

Uploads a payslip or document (encoded as Base64) and associates it with an employee record.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes
Content-Type	application/json	Yes

Request Body

Field	Type	Required	Description
country	string	Yes	2-character country code of the employee's document
doc	string	Yes	Employee document number
file	string	Yes	File content encoded as Base64
file_name	string	Yes	Original file name (e.g. recibo_julio.pdf)
tipo_doc	string	Yes	Document type code (e.g. RECIBO)
mes	string	Yes	Target month — format YYYY-MM

Example

curl -X POST https://api.mitrabajo.uy/recibo-importar \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "UY",
    "doc": "12345678",
    "file": "JVBERi0xLjQKJ...",
    "file_name": "recibo_julio_2026.pdf",
    "tipo_doc": "RECIBO",
    "mes": "2026-07"
  }'

Response

{ "code": 0, "message": "Archivo guardado" }

---

Habilidades

GET https://api.mitrabajo.uy/habilidades

Returns the list of skill/task codes available for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/habilidades \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

[
  { "id": 1, "nombre": "Conducción" },
  { "id": 2, "nombre": "Primeros auxilios" },
  { "id": 3, "nombre": "Atención al cliente" }
]

---

Leave Types

GET https://api.mitrabajo.uy/leave-types

GET https://api.mitrabajo.uy/leave-types/{id}

Returns the list of leave/absence types configured for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/leave-types \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

{
  "items": [
    { "id": 1, "name": "Vacaciones" },
    { "id": 2, "name": "Licencia médica" },
    { "id": 3, "name": "Licencia sin goce de sueldo" }
  ],
  "_links": {
    "self": { "href": "https://api.mitrabajo.uy/leave-types?page=1" }
  },
  "_meta": {
    "totalCount": 3,
    "pageCount": 1,
    "currentPage": 1,
    "perPage": 20
  }
}

---

Leave Periods

GET https://api.mitrabajo.uy/leave-periods

GET https://api.mitrabajo.uy/leave-periods/{id}

Returns the list of leave/absence period records configured for your account.

Request Headers

Header	Value	Required
X-Api-Key	Your access token	Yes

Request Body

None.

Example

curl https://api.mitrabajo.uy/leave-periods \
  -H "X-Api-Key: EPZoeOHHDPz-ucc5HweJYt6xehe_1bV-"

Response

```json { "items": [ { "id": 1, "name": "Período vacacional 2026" }, { "id": 2, "name": "Licencias médicas Q1 2026" } ], "_links": { "self": { "href": "https://api.mitrabajo.uy/leave-periods?page=1" } }, "_meta": { "totalCount": 2, "pageCount": 1, "currentPage": 1, "perPage": 20 } }