API Response Codes

Refer to the below response code glossary to help you troubleshoot any errors.

Response Code

Messages

JavaScript Web API Explanation(s)

REST API Explanation(s)

200 OK

The request was successful!

N/A

N/A

401 Unauthorized

Participant authentication is required.

If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email)

N/A

403 Forbidden

  1. You are not allowed to perform that action.

  2. No valid participant access token provided.

  1. This may be due to the URL not matching what is configured for your campaign. Also, check your whitelisted URLs.

  2. If an existing participant is trying to access their account, they need to first authenticate (by logging in via one-time access token link in email)

  1. Your API key may be revoked or contain a typo, or you may be trying to interact with another user's campaign or participant data (which is not allowed).

429 Too Many Requests

You have reached the rate limit.

You have reached the rate limit OR You have reached the usage limit in your current plan.

5XX Internal Server Error

The GrowSurf server is inaccessible or offline -- that's our fault! Check for updates on our status page.

N/A

N/A