API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

Getting started API reference Store API Finance API Settings API Insights API Wholesale API Resources

Opening hours Ordering schedule Delivery settings

Settings API

Opening hours

Read and set a store's weekly opening hours — the same schedule as the dashboard's Opening hours screen. One schedule per store; omit store_id for your main store.

Get opening hours

All seven days, with defaults filled for any day not yet set.

GET /api/v2.0/third-party/opening-hours

Signed

Query parameters

Field	Type	Required	Description
`store_id`	integer	Optional	A branch id you own. Omit (or leave blank) for the main store.

Response

{
    "data": {
        "store_id": null,
        "week": {
            "sat": {
                "is_open": true,
                "start_time": "09:00",
                "end_time": "22:00"
            },
            "sun": {
                "is_open": true,
                "start_time": "09:00",
                "end_time": "22:00"
            },
            "fri": {
                "is_open": false,
                "start_time": null,
                "end_time": null
            }
        }
    }
}

Set opening hours

Replaces the whole week. Send all seven days; a closed day needs no times.

PUT /api/v2.0/third-party/opening-hours

Signed

Body parameters

Field	Type	Required	Description
`store_id`	integer	Optional	A branch you own, or null for the main store.
`week`	object	Required	Keys sat,sun,mon,tue,wed,thu,fri. Each has is_open (bool) and, when open, start_time and end_time as HH:MM.

Notes

Times are 24-hour HH:MM. A closed day stores no times whatever you send.
end_time must be after start_time — overnight ranges are not supported (same as the dashboard).
A store_id that is not yours is rejected with HTTP 422.

Previous Transactions Next Ordering schedule