Errors

POAP uses conventional HTTP response codes to indicate the success or failure of an API request. Below are a few common errors.

Our libraries raise exceptions for many reasons, such as a failed transaction, invalid parameters, authentication errors, and network unavailability. We recommend writing code that gracefully handles all possible API exceptions.

SECRET_CODE_MISSING

The secret code is missing.

400 LIMIT_EXCEEDED

The total number of POAPs available to mint have been minted. There are no additional POAP mints available for the Secret Word or Website delivery method.

400 INVALID_SECRET

The Secret Word provided to mint this POAP is not valid. Please contact the issuer.

400 INVALID_SECRET_CODE

The secret code provided is invalid.

400 SNAPSHOT_BAD_REQUEST

A bad request response has been received from Snapshot. Unknown parameter, please check the information you are sending, and review the documentation.

400 EDITION_EXPIRED

The editing window for this resource has expired. Events can only be edited within 30 days of the event start date.

400 EVENT_EXPIRED

The event timeframe has expired.

400 EVENT_EDIT_BAD_REQUEST

The request did not process and was malformed when editing an event.

401 INVALID_CREDENTIALS

The credentials provided to access are either incorrect or invalid. Please provide valid credentials to access the API. Credentials can be requested here.

401 UNAUTHORIZED

Unauthorized user; you currently do not have authorization to access this. This is related to your auth token permissions. Permissions may vary based on what you are trying to access vs. the permission setup on your access level.

401 ERROR

This could be because you don’t have headers or because you are using invalid or incorrect tokens. Please check to ensure you have included headers correctly and that you are using valid tokens.

403 FORBIDDEN

User does not have authorization to access the resource. These are related to your auth token permissions. Permissions may vary based on what you are trying to access vs. the permission setup on your access level.

404 THEGRAPH_INTERNAL_SERVER_ERROR

This is an internal server error, or mishandled response from The Graph service.

404 SNAPSHOT_NOT_FOUND

We did not find a Snapshot response. Unknown parameter, please check the information you are sending, and review the documentation.

404 NOT_FOUND

The resource you are looking for can’t be found or is invalid. Unknown parameter, please check the information you are sending, and review the documentation.

404 EVENT_NOT_FOUND

The event ID provided doesn’t exist or is invalid. Please provide a valid event ID.

500 SNAPSHOT_INTERNAL_SERVER_ERROR

Internal service error, or mishandled response from Snapshot.

500 ERROR

The API is down. If you receive this error, please send it to [email protected] so we can check this on our end. Our team needs to identify the root cause and troubleshoot.