Error Codes

Most errors from the NFTPort API include an error code: a machine-readable code with a brief explanation.

Below is a list of possible error codes, along with additional information about how to resolve them.

To debug the API calls you have made recently, you can see a log of API calls you have made in the dashboard.

Status code	Error code	Explanation
Access
401	`authorization_missing`	Your request is missing an API key. Add your API key to the `Authorization:` header. You can find your API key in the dashboard.
401	`invalid_api_key`	You're using an incorrectly formatted API key. Make sure the key is formatted as a valid UUID.
403	`invalid_credentials`	The API key you're using does not correspond to any NFTPort account. Check if you're using the correct API key. You can find your API key in the dashboard.
403	`account_suspended`	Your API key is valid but your account is suspended. Please reach out to NFTPort support for more information.
Request validation
422	`invalid_address`	You provided an invalid address. Check that the wallet and contract addresses you're sending are valid EVM addresses.
422	`chain_not_supported`	This chain is not supported for this endpoint. Check which features are support for each chain.
422	`invalid_date`	You provided an invalid date. Check that you're providing valid ISO-formatted date.
422	`invalid_continuation_string`	You provided an invalid continuation string. Make sure you're using the correct continuation string you received from a previous request.
422	`page_number_not_supported`	Paging by page number is not supported for this endpoint. Switch to using continuation strings.
422	`value_error`	You provided an invalid value. See error message for details.
422	`invalid_enumeration`	You provided an invalid choice for a parameter. See error message for list of allowed values.
422	`parameter_missing`	The request is missing a required parameter. See error message for details and please make sure the parameter is present.
422	`invalid_type`	You provided a value of invalid type. See error message for details.
422	`invalid_url`	You provided an invalid URL. Make sure the input you provided is a valid URL.
422	`invalid_file_type`	The input file type you provided is not supported. See error message for supported file types.
422	`invalid_attribute_value`	You provided an invalid NFT metadata attribute value. See error message for details.
422	`invalid_token_id`	You provided an invalid token ID. See error message for details.
422	`invalid_token_quantity`	You provided an invalid token quantity. Make sure the token quantity is a positive integer.
422	`invalid_transaction_hash`	You provided an invalid transaction hash. Check that you're providing a correctly formatted transaction hash.
422	`request_too_large`	The request contains too much data to write onto the blockchain in one request. Please reduce the number of tokens in your request.
Hitting account limits and quotas
403	`mint_limit_exceeded`	You've reached the maximum number of NFTs possible to mint on your account (in this billing period). Please see Quotas or check your usage in the dashboard.
403	`contract_limit_exceeded`	You've reached the maximum number of contracts possible to deploy on your account (in this billing period). Please see Quotas or check your usage in the dashboard.
403	`transaction_limit_exceeded`	You've reached the maximum number of transactions possible to make on your account (in this billing period). Please see Quotas or check your usage in the dashboard.
429	`too_many_requests`	Too many requests hit the API too quickly. Make your requests at a lower rate. See Rate limits.
Other client errors
400	`invalid_request`	The request you made was invalid. Please see error message for a description of the problem.
400	`contract_not_supported`	The contract does not support the action you requested. Check which actions are disabled on your contract, deploy a new contract, or reach out to NFTPort support.
400	`failed_to_fetch_file`	We failed to fetch the URL you supplied. Please make sure the URL is correct and a file is available at this URL.
400	`too_many_files`	You attempted to upload more files in a single request than the endpoint allows. Please reduce the number of files in your request.
400	`transaction_failed`	The transaction (e.g. contract deployment) failed. Please retry the transaction.
403	`forbidden`	This action is forbidden on this resource. Please see error message for details.
404	`not_found`	The requested resource was not found. Make sure your request parameters are correct.
404	`transaction_pending`	The transaction is not yet recorded on chain. Please check again in a few seconds.
405	`method_not_allowed`	You attempted to use a HTTP method the endpoint doesn't support (e.g. made a GET request to a POST-only endpoint). Make sure you're using the correct method.
Server errors (see NFTPort status)
500	`internal_server_error`	An unexpected error occurred when processing your request. Please reach out to NFTPort support.
502	`bad_gateway`	An external service returned an error, causing your request to fail. Please reach out to NFTPort support.
503	`too_many_pending_transactions`	Due to high load, there are too many on-chain transactions queued. Please try again shortly or reach out to NFTPort support.
503	`gas_price_too_high`	Due to high gas fees on the network, your request was rejected. Please try again when gas fees are lower or reach out to NFTPort support.