Skip to main content

Identity Playground

Explore the DIMO Identity API using the interactive query builder and GraphQL playground below.

Query Builder​

Use the interactive query builder to quickly generate common Identity API queries. Select a query from the categories, fill in any required variables, and copy the generated query to use in the playground below.

1. Select Query Type

Choose what type of data you want to query from the Identity API

GraphQL Playground​

You can also run queries directly against the live API endpoint using the GraphQL playground below.

DIMO Identity API Playground

Open in New Tab →

💡 Tip: You can interact with the playground above or open it in a new tab for a full-screen experience.

Common Queries​

Below are common queries you can try in the playground above. Simply copy any query and paste it into the playground to execute it.

General Info​

Getting the total count of vehicles on the DIMO Network
query GetTotalVehicles {
  vehicles (first: 10) {
    totalCount
  }
}

Developer License Info​

Getting information on Developer License for a given License Token ID
query GetDevLicenseByTokenId {
  developerLicense (by: { tokenId: <dev_license_token_id> } ) {
    owner
    tokenId
    alias
    clientId
    mintedAt
    redirectURIs (first: 10) {
      nodes {
        uri
        enabledAt
      }
    }
  }
}
Getting a list of Vehicle Token IDs and Token DIDs granted to a given Developer License
query GetVehicleByDevLicense {
  vehicles(filterBy: { privileged: "<dev_license_0x>" }, first: 100) {
    nodes {
      owner
      tokenId
      tokenDID
      definition {
        make
        model
        year
      }
    }
  }
}

Vehicle Ownership Info​

Getting the total count of vehicles for a given owner
query GetVehiclesByOwner {
  vehicles(filterBy: {owner: "<0x_address>"}, first: 100) {
    totalCount
  }
}
Getting a Make/Model/Year and vehicle tokenId, tokenDID list for a given owner
query GetVehicleMMYByOwner {
  vehicles(filterBy: {owner: "<0x_Address>"}, first: 100) {
    nodes {
      tokenId
      tokenDID
      definition {
        make
        model
        year
      }
    }
  }
}

Vehicle Basic Info​

Getting Make/Model/Year and owner address for a given Vehicle Token ID
query GetVehicleMMYByTokenId {
  vehicle (tokenId: <token_id>) {
    owner
    definition {
      make
      model
      year
    }
  }
}

Vehicle Permissions (SACD) Info​

Permissions are encoded in hexadecimals - reference the common permissions table for details.

Getting permissions shared for a given Vehicle Token ID
query GetSacdForVehicle {
  vehicle (tokenId: 3) {
    sacds (first: 10) {
      nodes {
        permissions
        grantee
        source
        createdAt
        expiresAt
      }
    }
  }
}

Rewards​

Getting the Rewards data for a given owner
query GetRewardsByOwner {
  rewards (user: "<0x_address>") {
    totalTokens
  }
}
Getting the Reward history for a given owner
query GetRewardHistoryByOwner {
  vehicles(filterBy: {owner: "<0x_address>"}, first: 10) {
    nodes {
      earnings {
        history (first: 10) {
          edges {
            node {
              week
              aftermarketDeviceTokens
              syntheticDeviceTokens
              sentAt
              beneficiary
              connectionStreak
              streakTokens
            }
          }
        }
        totalTokens
      }
    }
  }
}

Vehicle Device Definitions​

Getting the Device Definition ID by a given Vehicle Token ID
query GetDDIdByVehicleTokenId {
  vehicle(tokenId: <vehicle_token_id>) {
    definition {
      id
    }
  }
}
Getting the Device Definitions by Device Definition ID
query GetDefinitionByDeviceId {
  deviceDefinition (by: { id: "<device_definition_id>"})  {
    year
    model
    attributes {
      name
      value
    }
  }
}