Retrieve a Block

client.blocks.retrieve(args: GetBlockParameters): Promise<GetBlockResponse>

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_TOKEN })

const block = await notion.blocks.retrieve({
  block_id: "your-block-id",
})

console.log(block.type) // "paragraph"
if (block.type === "paragraph") {
  console.log(block.paragraph.rich_text)
}

const codeBlock = await notion.blocks.retrieve({
  block_id: "code-block-id",
})

if (codeBlock.type === "code") {
  console.log("Language:", codeBlock.code.language)
  console.log("Code:", codeBlock.code.rich_text)
  console.log("Caption:", codeBlock.code.caption)
}

// Override the client's auth token for this request
const block = await notion.blocks.retrieve({
  block_id: "your-block-id",
  auth: "secret_custom_token",
})

const block = await notion.blocks.retrieve({
  block_id: "your-block-id",
})

if (block.has_children) {
  console.log("This block has child blocks")
  // You can fetch children using blocks.children.list()
}

import { isFullBlock } from "@notionhq/client"

const block = await notion.blocks.retrieve({
  block_id: "your-block-id",
})

if (isFullBlock(block)) {
  // TypeScript knows this is a full BlockObjectResponse
  console.log(block.created_time)
  console.log(block.last_edited_time)
}

import { APIResponseError } from "@notionhq/client"

try {
  const block = await notion.blocks.retrieve({
    block_id: "your-block-id",
  })
  console.log(block)
} catch (error) {
  if (APIResponseError.isAPIResponseError(error)) {
    switch (error.code) {
      case "object_not_found":
        console.error("Block not found")
        break
      case "unauthorized":
        console.error("Not authorized to access this block")
        break
      default:
        console.error("API error:", error.message)
    }
  }
}