API Token
To generate GoodDay API token go to Organization / Settings / API screen and click generate button.
Authentication
To authenticate pass gd-api-token variable with your API key either in request header, query string or a cookie.
Example
curl --header "gd-api-token: YOUR-API-TOKEN" https://api.goodday.work/2.0/users
https://api.goodday.work/2.0/users?gd-api-token=YOUR-API-TOKEN
Make sure you connect via https, the API does not operate via http.
Rate Limits
Each GoodDay organization is limited to 100 API requests per minute.
The limit is shared across all requests made using the organization's API token.
The limit resets at the start of each minute.
Rate Limit Headers
Every authenticated response includes the following headers:
| Header |
Description |
| X-RateLimit-Limit |
Maximum requests per minute. |
| X-RateLimit-Remaining |
Requests remaining in the current minute. |
| X-RateLimit-Reset |
Unix timestamp when the limit resets. |
| Retry-After |
Seconds to wait before retrying. Returned with 429 responses. |
Error Handling
When the rate limit is exceeded, the API returns 429 Too Many Requests.
The request is not processed.
On 429 responses, wait for the duration specified in
Retry-After before retrying.
Higher Limits
Enterprise organizations can request higher limits by contacting
support@goodday.work
with their integration details and expected request volume.