API 2.0
Connection

Connection

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.