Skip to main content

​
Basic Usage

Fetch a single item by its ID: 
const [post, error] = await nc.query.blog.get('page-id-123');

if (!error) {
  console.log(post.title, post.content);
}

​
Type Safety

NotCMS provides full type inference for fetched items: 
// Infer single page type
type BlogPost = typeof nc.query.blog.$inferPage;

// Use in your functions
function processBlogPost(post: BlogPost) {
  // Full type safety and IDE autocomplete
  console.log(post.title);
  console.log(post.published);
  console.log(post.author);
}
Fetch related items using multiple queries: 
async function getPostWithAuthor(postId: string) {
  // Get the post
  const [post, postError] = await nc.query.blog.get(postId);
  if (postError) throw postError;
  
  // Get the author
  const [author, authorError] = await nc.query.authors.get(post.properties.authors[0]);
  if (authorError) throw authorError;
  
  return {
    ...post,
    author
  };
}

​
Next Steps

List Items

Learn to query multiple items

Client API

Explore the complete Client API