📜Get ERC1155 Data

Given an ERC1155 tokenId, get every internal tokenId, along with metadata and internal deposit address.

Base URL

All API requests should be made to the following base URL:


API Endpoints

Get All Backing IDs for a Token ID

Fetches metadata information related to the given token ID.


GET {baseURL}/allBackingIdsForTokenId/:tokenId

Path Parameters:

  • tokenId (required): The token ID for which metadata is being requested.


  • x-api-key (required): Your API key. It should be sent in the request header.


  • 200 OK - The request was successful, and the metadata is returned.

    Example successful response:

        "balanceOnChain": 1,
        "claimed": [],
        "claimedIds": [],
        "serialNumber": "36119496532326007048069238652025686750025823909618387553508980281319231399864",
        "unclaimedSerial": true,
        "serialNumberUsed": false,
        "liveIds": [
        "liveSerialNumbers": [
        "liveAddresses": [
        "errors": [],
        "errorsIds": [],
        "mintables": [],
        "mintablesIds": [],
        "mintablesAddresses": [],
        "allGroupingLengthsMatch": true,
        "currentMetadataFoundInMintableList": false,
        "loaded": false

  • 401 Unauthorized - The request was made with an incorrect or missing API key.

    Example response when no API key is provided:

        "error": "No API key detected"

    Example response when the API key is incorrect:

        "error": "Unauthorized"

  • 400 Bad Request - The request was unsuccessful due to incorrect input or an error in processing. Check the response body for more information.

    Example response for not curated token ID:

        "success": false,
        "error": "Not curated tokenId"


Here's an example using the request library in Node.js to make a request to the API with the provided tokenId:

const request = require('request');

const tokenId = '14348293833920273912990111611620811208434744638373632813897914200493984998646';
const baseUrl = 'https://v2.emblemvault.io';
const apiKey = 'your_api_key_here'; // Replace with your actual API key

const options = {
 url: `${baseUrl}/allBackingIdsForTokenId/${tokenId}`,
 headers: {
   'x-api-key': apiKey,

request(options, (error, response, body) => {
 if (!error && response.statusCode === 200) {
   const parsedBody = JSON.parse(body);
 } else {
   console.log('Error:', error);
   console.log('Status Code:', response.statusCode);
   console.log('Body:', body);


curl -X GET \
 'https://v2.emblemvault.io/allBackingIdsForTokenId/14348293833920273912990111611620811208434744638373632813897914200493984998646' \
 -H 'x-api-key: your_api_key_here'

Last updated