How to Handle NFT API Errors?

Written by Killiane Menand

Published on October 1, 20241 min read

---

While we work to ensure that every NFT's metadata is returned when requested from the API, there are various reasons why we may not able to fulfill your request.

Below is a breakdown of the most common error types, how they occur, and how you should handle them.

Retryable Errors

These errors have a strong chance of being resolved with a repeated attempt:

1. Token URI responded with a non-200 response code

2. Throttled token URI

3. IPFS gateway timed out

4. Centralized gateway timed out (try again with a higher token URI timeout)

5. Arweave gateway timed out

6. Internal service error

You may retry requests with these errors as there’s a high probability of success on subsequent attempts.

Below are more detailed breakdowns of what many of our errors mean and how to approach them.

Token Does Not Exist