ENDPOINTS

Escalas

Consulte as escalas de trabalho da equipe ou de um colaborador específico para um período.

ℹ️

O período máximo por consulta é de 31 dias. Para períodos maiores, pagine as requisições ajustando from e to.

GET/v1/schedulesschedules:read

Retorna as escalas de todos os colaboradores ativos no período informado.

Query parameters

Campo	Tipo	Obrig.	Descrição
`from`	string (ISO 8601)	sim	Data inicial do período.
`to`	string (ISO 8601)	sim	Data final do período (máx 31 dias após from).
`limit`	integer	não	Itens por página (padrão: 50, máx: 100).

curl "https://api.meuponto360.com/v1/schedules?from=2026-04-01&to=2026-04-30" \
  -H "x-api-key: mp360_sk_sua_chave"

200 OK

[
  {
    "employeeId": "a1b2c3d4-...",
    "employeeName": "João Silva",
    "schedule": {
      "id": "sched-uuid",
      "name": "Comercial 08-17",
      "workDays": ["MON", "TUE", "WED", "THU", "FRI"],
      "startTime": "08:00",
      "endTime": "17:00",
      "toleranceMinutes": 10
    },
    "days": [
      {
        "date": "2026-04-01",
        "dayOfWeek": "WED",
        "isWorkDay": true,
        "expectedMinutes": 540,
        "startTime": "08:00",
        "endTime": "17:00"
      }
    ]
  }
]

GET/v1/schedules/:employeeIdschedules:read

Retorna a escala de trabalho de um colaborador específico no período.

Path parameters

Campo	Tipo	Obrig.	Descrição
`employeeId`	string (UUID)	sim	ID do colaborador.

Query parameters

Campo	Tipo	Obrig.	Descrição
`from`	string (ISO 8601)	sim	Data inicial do período.
`to`	string (ISO 8601)	sim	Data final do período (máx 31 dias após from).

curl "https://api.meuponto360.com/v1/schedules/a1b2c3d4-...?from=2026-04-01&to=2026-04-30" \
  -H "x-api-key: mp360_sk_sua_chave"