Skip to content


Used to fetch data from a collection based on a specific key and value pairing. It will return all documents as an array that match the key and value pair.



  • key -> string
    • An identifier to help find the document you are looking for.
    • Example: 'model'
  • value -> any
    • A value that should correspond under that specific key's value.
    • Example: 'infernus'
  • collection -> string
    • The name of the collection to fetch data from.
    • Example: 'vehicles'


  • Promises to return an Array of documents if found. Otherwise an empty array.
interface IVehicle {
    _uid?: unknown;
    model: string;

async function fetchSomething() {
    const results = await Athena.database.funcs.fetchAllByField<IVehicle>('model', 'infernus', 'vehicles');
    if (!results || results.length <= 0) {
        console.log('Could not find any infernuses.');
    console.log('Found all the infernuses owned by players.');
    return results;

Created by Stuyk | Est. 2020