API Response Codes

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

Glossary

Response Code

Messages

REST API Explanation(s)

200 OK

The request was successful!

N/A

400 Bad Request

Request validation failed on an input.

Check that your inputs are entered correctly.

402 Usage Limit

Participant quota has been exhausted.

You've reached a plan limit and will need to upgrade to the next tier.

403 Not Authorized

You are not allowed to perform that action.

Your API key may be revoked or contain a typo, or you may be trying to interact with another user's program or participant data (which is not allowed). Verify that your API key has access permission to the campaign (or if you are a team member, make sure you have an Admin role within the team or that you have API access to the campaign).

404 Resource Not Found

The requested resource does not exist.

You may be trying to request a resource that does not exist or was deleted.

409 Conflict Duplicate Request

Conflicting duplicate request.

If a request is made but has not finished and that exact same request is made.

More details on the specific request will be provided within the returned error.

422 Participant Blocked

Participant was detected as a high-risk fraudster and was blocked from joining.

The person may be a high-risk fraudster, and has been blocked from entering the program. Learn more about how LoyaltySurf's anti-fraud system worksarrow-up-right. Please check that your program's anti-fraud settings are not set to Strict, or that you do not have the email or IP address blacklisted.

429 Too Many Requests

You have reached a rate limit.

You have sent too many requests in a given time OR You have reached the usage limit in your current plan.

5XX Internal Server Error

The LoyaltySurf server is inaccessible or offline -- that's our fault! Check for updates on our status pagearrow-up-right.

N/A

Last updated

Was this helpful?