NFT Endpoints

Get NFTs by identifiers

Changed on Nov 3, 2026

Retrieve multiple NFTs in a single request by providing a list of identifiers (chain, contract address, and token ID). Not-found NFTs are silently omitted from the response.

post/api/v2/nfts/batch

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/nfts/batch/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "identifiers": [
    {
      "chain": "ethereum",
      "contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "token_id": "1"
    }
  ]
}

Response

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  the // response's property type changed from object to no type for status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property // to the response with the status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status

Operation history