GET/api/v1/schedules

Get Schedules

List of all Schedules

A schedule is a method to program in time the extractions of shops. For example a shop can be scheduled to extract at 8am every day, or another shop can be extracted on Tuesdays only. This API provides a list and details of all user schedules. Users can access this endpoint to obtain details about each schedule, including the schedule name, year, month, and other relevant information.

Upon a successful request, the system will respond with a JSON object containing all information of all schedules.

GET/api/v1/schedules

Parameter Details

Name	In	Type	Required	Description
`page`	query	`integer`	Optional	The page number to retrieve.
`size`	query	`integer`	Optional	The number of items to be displayed per page.

Responses

Status	Meaning	Description	Schema
200	OK	Success
400	Bad Request	Request data failed validation(s)	None
401	Unauthorized	Authentication Failed!	None
429	Too Many Requests	Too Many Requests.	None
500	Internal Server Error	Internal Server Error	None

Example Request

# You can also use wget
curl -X GET https://api.flightrates.example.com/api/v1/schedules \
  -H 'Accept: application/json' \
  -H 'Authorization: API_KEY'

Example responses

200 Response

{
  "error": false,
  "schedules": [
    {
      "_id": "6a0becec9650dadda773d068",
      "scheduleName": "#1 Flightschedule name",
      "_shop": "6a0bea8e9650dadda773d04b",
      "_timezone": "64ae7e58d06e77f95bff0565",
      "timezoneName": "Europe/Mariehamn",
      "minute": "0",
      "hour": "*",
      "dayOfMonth": "*",
      "month": "*",
      "dayOfWeek": "*",
      "isActiveStatus": true,
      "startDate": "2026-05-19",
      "endDate": "2026-05-19",
      "_user": "6a0aaf8da93611b858a5abf8",
      "userName": "testinbound",
      "vertical": "flightrates",
      "isCustomerCreated": true,
      "crontabExpression": "0 * * * *",
      "nextRunAt": "2026-05-19T06:00:00.000Z",
      "lastRunAt": null,
      "createdAt": "2026-05-19T04:54:04.903Z",
      "updatedAt": "2026-05-19T04:54:04.903Z",
      "crontabHuman": "Every hour, every day",
      "id": "6a0becec9650dadda773d068"
    }
  ],
  "totalData": 1,
  "totalPages": 1,
  "page": 1,
  "size": 10
}

PreviousBulk Schedule Upload

NextSample Schedule

Need Support?

Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.

Contact Support

About Us