Operaciones

Empleados y centros

Las personas de la empresa, sus centros y las invitaciones.

Listar empleados

GET /v1/employees

Pide el permiso employees:read.

Parámetros

`email` opcional	string (email)	Correo exacto.
`employeeCode` opcional	string	El código que la empresa le dio a la persona.
`worksiteId` opcional	string
`status` opcional	ACTIVE \| ENDED
`limit` opcional	integer
`cursor` opcional	string	El `nextCursor` de la página anterior.

Respuesta 200

Cada elemento de data:

`id`	string
`displayName`	string	El nombre completo, como está en MiJornada.
`firstName`	string	La primera palabra del nombre. Es una estimación.
`lastName`	string	El resto del nombre. Es una estimación.
`email`	string (email) \| null
`employeeCode`	string \| null
`worksiteId`	string \| null
`status`	ACTIVE \| ENDED
`employmentStartDate`	string (date) \| null
`createdAt`	string (date-time) \| null
`updatedAt`	string (date-time)

Errores posibles: 401, 403, 422, 429.

Ejemplo

curl "https://api.mijornada.app/v1/employees" \
  -H "Authorization: Bearer mj_live_…"

Respuesta de ejemplo

{
  "data": [
    {
      "id": "abc123",
      "displayName": "Ana García López",
      "firstName": "Ana",
      "lastName": "García López",
      "email": "ana@example.com",
      "employeeCode": "E014",
      "worksiteId": "centro-1",
      "status": "ACTIVE",
      "employmentStartDate": "2026-10-15",
      "createdAt": "2026-10-15T07:02:11Z",
      "updatedAt": "2026-10-15T07:02:11Z"
    }
  ],
  "nextCursor": null
}

Ver un empleado

GET /v1/employees/{id}

Pide el permiso employees:read.

Parámetros

id obligatorio string

Respuesta 200

`id`	string
`displayName`	string	El nombre completo, como está en MiJornada.
`firstName`	string	La primera palabra del nombre. Es una estimación.
`lastName`	string	El resto del nombre. Es una estimación.
`email`	string (email) \| null
`employeeCode`	string \| null
`worksiteId`	string \| null
`status`	ACTIVE \| ENDED
`employmentStartDate`	string (date) \| null
`createdAt`	string (date-time) \| null
`updatedAt`	string (date-time)

Errores posibles: 401, 403, 404, 429.

Ejemplo

curl "https://api.mijornada.app/v1/employees/abc123" \
  -H "Authorization: Bearer mj_live_…"

Respuesta de ejemplo

{
  "id": "abc123",
  "displayName": "Ana García López",
  "firstName": "Ana",
  "lastName": "García López",
  "email": "ana@example.com",
  "employeeCode": "E014",
  "worksiteId": "centro-1",
  "status": "ACTIVE",
  "employmentStartDate": "2026-10-15",
  "createdAt": "2026-10-15T07:02:11Z",
  "updatedAt": "2026-10-15T07:02:11Z"
}

Listar centros

GET /v1/worksites

Pide el permiso employees:read.

Respuesta 200

Cada elemento de data:

`id`	string
`name`	string
`address`	string
`legalName`	string \| null
`taxId`	string \| null

Errores posibles: 401, 403, 429.

Ejemplo

curl "https://api.mijornada.app/v1/worksites" \
  -H "Authorization: Bearer mj_live_…"

Respuesta de ejemplo

{
  "data": [
    {
      "id": "abc123",
      "name": "Obrador",
      "address": "Calle Mayor 1, Sevilla",
      "legalName": "Pastelería Ejemplo SL",
      "taxId": "B00000000"
    }
  ],
  "nextCursor": null
}

Invitar a un empleado

POST /v1/invitations

Envía por correo a la persona un código para unirse a la empresa. El código no se devuelve aquí: es lo que deja entrar. Asientos, duplicados y el tope del plan funcionan como en MiJornada. Máximo 60 invitaciones por hora y clave. Pide el permiso invitations:write.

Parámetros

Idempotency-Key opcional string Repite la petición con el mismo valor y solo se ejecuta una vez. Se guarda 24 horas.

Cuerpo

`fullName` obligatorio	string
`email` obligatorio	string (email)
`employmentStartDate` obligatorio	string (date)	No puede estar en el futuro.
`locale` opcional	es \| en
`worksiteId` opcional	string

Respuesta 201

`id`	string
`displayName`	string
`email`	string (email)
`locale`	string
`worksiteId`	string \| null
`employmentStartDate`	string (date)
`expiresAt`	string (date-time)
`deliveryStatus`	PENDING

Errores posibles: 401, 403, 409, 422, 429.

Ejemplo

curl -X POST "https://api.mijornada.app/v1/invitations" \
  -H "Authorization: Bearer mj_live_…" \
  -H "Content-Type: application/json" \
  -d '{"fullName":"…","email":"ana@example.com","employmentStartDate":"2026-10-15"}'

Respuesta de ejemplo

{
  "id": "abc123",
  "displayName": "Ana García López",
  "email": "ana@example.com",
  "locale": "es",
  "worksiteId": "centro-1",
  "employmentStartDate": "2026-10-15",
  "expiresAt": "2026-10-15T07:02:11Z",
  "deliveryStatus": "PENDING"
}

Última actualización de esta página: 31 de octubre de 2026.