Get a schedule

Use this endpoint to retrieve a specific reconciliation schedule by its identifier.

GET /v1/contexts/{contextId}/schedules/{scheduleId}

Get a schedule

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/contexts/{contextId}/schedules/{scheduleId} \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00Z",
  "cronExpression": "0 0 * * *",
  "enabled": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "updatedAt": "2025-01-15T10:30:00Z",
  "lastRunAt": "2025-01-15T10:30:00Z",
  "nextRunAt": "2025-01-16T00:00:00Z"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de ruta

contextId · string<uuid> · requerido

The unique identifier of the reconciliation context. Context ID

scheduleId · string<uuid> · requerido

The unique identifier of the schedule. Schedule ID

Respuesta

200

application/json

Schedule details

contextId · string · requerido

Identifier of the context this schedule belongs to.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

createdAt · string · requerido

Creation timestamp in RFC 3339 format.

Ejemplo:

"2025-01-15T10:30:00Z"

cronExpression · string · requerido

Cron expression (5-field) defining when the reconciliation runs.

Ejemplo:

"0 0 * * *"

enabled · boolean · requerido

Whether the schedule is active.

Ejemplo:

true

id · string · requerido

Unique identifier of the schedule.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

updatedAt · string · requerido

Last update timestamp in RFC 3339 format.

Ejemplo:

"2025-01-15T10:30:00Z"

lastRunAt · string

Timestamp of the last successful run in RFC 3339 format; omitted if it has never run.

Ejemplo:

"2025-01-15T10:30:00Z"

nextRunAt · string

Timestamp of the next scheduled run in RFC 3339 format; omitted when disabled.

Ejemplo:

"2025-01-16T00:00:00Z"