Get a specific page by ID

curl --request GET \
  --url http://localhost:3000/v2/pages/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:3000/v2/pages/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "3000",
  CURLOPT_URL => "http://localhost:3000/v2/pages/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:3000/v2/pages/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://localhost:3000/v2/pages/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "page",
  "id": "p_abc123",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T14:45:00.000Z",
  "kind": "report",
  "title": "<string>",
  "agent": {
    "type": "none"
  },
  "assignee": [
    {
      "type": "user_id",
      "user_id": "<string>"
    }
  ],
  "targets": [
    {
      "type": "company",
      "company": {
        "id": "cmp_abc123",
        "document": "12345678000190",
        "tradeName": "Acme Corp",
        "legalName": "Acme Ltda",
        "icon": {
          "type": "emoji",
          "emoji": "page_icon",
          "external": {
            "url": "https://example.com/image.jpg"
          },
          "file_upload": {
            "id": "fu_abc123"
          },
          "domain": "acme.com",
          "file": {
            "url": "https://s3.amazonaws.com/...",
            "expiryTime": "2024-01-15T10:30:00.000Z"
          },
          "lucide": "file-text",
          "brand": "github",
          "dicebear": {
            "style": "notionists-neutral",
            "seed": "0256de50-f90c-49a8-81f0-3988b2b89d8d",
            "backgroundColor": "b6e3f4,b6e3f4",
            "options": {
              "shape": "circle",
              "bodyColor": "<string>",
              "animationVariant": "fastest",
              "brows": "<string>",
              "eyes": "<string>",
              "glasses": "<string>",
              "lips": "<string>",
              "nose": "<string>",
              "flip": true,
              "rotate": 123,
              "scale": 123,
              "radius": 123,
              "size": 123,
              "backgroundType": "solid",
              "backgroundRotation": [
                123
              ],
              "translateX": 123,
              "translateY": 123,
              "clip": true,
              "randomizeIds": true
            }
          },
          "background": "blue",
          "empty": true,
          "updatedBy": "dataset:empresas"
        }
      }
    }
  ],
  "permissions": {
    "allow": [
      "<string>"
    ],
    "deny": [
      "<string>"
    ],
    "ask": [
      "<string>"
    ]
  },
  "files": [
    {
      "type": "file_upload",
      "name": "<string>",
      "file_upload": {
        "id": "<string>"
      }
    }
  ],
  "pipelines": {},
  "properties": {},
  "relations": {},
  "summary": "<string>",
  "createdBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "updatedBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "icon": {
    "type": "emoji",
    "emoji": "page_icon",
    "external": {
      "url": "https://example.com/image.jpg"
    },
    "file_upload": {
      "id": "fu_abc123"
    },
    "domain": "acme.com",
    "file": {
      "url": "https://s3.amazonaws.com/...",
      "expiryTime": "2024-01-15T10:30:00.000Z"
    },
    "lucide": "file-text",
    "brand": "github",
    "dicebear": {
      "style": "notionists-neutral",
      "seed": "0256de50-f90c-49a8-81f0-3988b2b89d8d",
      "backgroundColor": "b6e3f4,b6e3f4",
      "options": {
        "shape": "circle",
        "bodyColor": "<string>",
        "animationVariant": "fastest",
        "brows": "<string>",
        "eyes": "<string>",
        "glasses": "<string>",
        "lips": "<string>",
        "nose": "<string>",
        "flip": true,
        "rotate": 123,
        "scale": 123,
        "radius": 123,
        "size": 123,
        "backgroundType": "solid",
        "backgroundRotation": [
          123
        ],
        "translateX": 123,
        "translateY": 123,
        "clip": true,
        "randomizeIds": true
      }
    },
    "background": "blue",
    "empty": true,
    "updatedBy": "dataset:empresas"
  },
  "agentFileId": "<string>",
  "content": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "<string>",
          "link": {
            "url": "<string>"
          }
        },
        "annotations": {
          "bold": true,
          "italic": true,
          "strikethrough": true,
          "underline": true,
          "code": true,
          "color": "<string>",
          "trend": "up"
        },
        "plain_text": "<string>",
        "href": "<string>"
      }
    ],
    "color": "<string>"
  },
  "parent": {
    "type": "page_id",
    "page_id": "<string>"
  },
  "usage": {
    "input": 123,
    "output": 123,
    "total": 123,
    "cacheReadInputTokens": 123,
    "cacheCreationInputTokens": 123,
    "cacheCreationEphemeral1hInputTokens": 123,
    "cacheCreationEphemeral5mInputTokens": 123,
    "totalInputTokens": 123,
    "durationSeconds": 123,
    "activeSeconds": 123,
    "claudeUsage": {},
    "claudeStats": {}
  },
  "runSessionId": {
    "object": "session",
    "id": "<string>",
    "status": "provisioning",
    "userId": "<string>",
    "agentVersion": 123
  },
  "url": "<string>"
}

GET

pages

{id}

Get a specific page by ID

curl --request GET \
  --url http://localhost:3000/v2/pages/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://localhost:3000/v2/pages/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "3000",
  CURLOPT_URL => "http://localhost:3000/v2/pages/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:3000/v2/pages/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://localhost:3000/v2/pages/{id}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "page",
  "id": "p_abc123",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T14:45:00.000Z",
  "kind": "report",
  "title": "<string>",
  "agent": {
    "type": "none"
  },
  "assignee": [
    {
      "type": "user_id",
      "user_id": "<string>"
    }
  ],
  "targets": [
    {
      "type": "company",
      "company": {
        "id": "cmp_abc123",
        "document": "12345678000190",
        "tradeName": "Acme Corp",
        "legalName": "Acme Ltda",
        "icon": {
          "type": "emoji",
          "emoji": "page_icon",
          "external": {
            "url": "https://example.com/image.jpg"
          },
          "file_upload": {
            "id": "fu_abc123"
          },
          "domain": "acme.com",
          "file": {
            "url": "https://s3.amazonaws.com/...",
            "expiryTime": "2024-01-15T10:30:00.000Z"
          },
          "lucide": "file-text",
          "brand": "github",
          "dicebear": {
            "style": "notionists-neutral",
            "seed": "0256de50-f90c-49a8-81f0-3988b2b89d8d",
            "backgroundColor": "b6e3f4,b6e3f4",
            "options": {
              "shape": "circle",
              "bodyColor": "<string>",
              "animationVariant": "fastest",
              "brows": "<string>",
              "eyes": "<string>",
              "glasses": "<string>",
              "lips": "<string>",
              "nose": "<string>",
              "flip": true,
              "rotate": 123,
              "scale": 123,
              "radius": 123,
              "size": 123,
              "backgroundType": "solid",
              "backgroundRotation": [
                123
              ],
              "translateX": 123,
              "translateY": 123,
              "clip": true,
              "randomizeIds": true
            }
          },
          "background": "blue",
          "empty": true,
          "updatedBy": "dataset:empresas"
        }
      }
    }
  ],
  "permissions": {
    "allow": [
      "<string>"
    ],
    "deny": [
      "<string>"
    ],
    "ask": [
      "<string>"
    ]
  },
  "files": [
    {
      "type": "file_upload",
      "name": "<string>",
      "file_upload": {
        "id": "<string>"
      }
    }
  ],
  "pipelines": {},
  "properties": {},
  "relations": {},
  "summary": "<string>",
  "createdBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "updatedBy": {
    "object": "user",
    "id": "u_abc123",
    "apiKeyId": "bsk_abc123"
  },
  "icon": {
    "type": "emoji",
    "emoji": "page_icon",
    "external": {
      "url": "https://example.com/image.jpg"
    },
    "file_upload": {
      "id": "fu_abc123"
    },
    "domain": "acme.com",
    "file": {
      "url": "https://s3.amazonaws.com/...",
      "expiryTime": "2024-01-15T10:30:00.000Z"
    },
    "lucide": "file-text",
    "brand": "github",
    "dicebear": {
      "style": "notionists-neutral",
      "seed": "0256de50-f90c-49a8-81f0-3988b2b89d8d",
      "backgroundColor": "b6e3f4,b6e3f4",
      "options": {
        "shape": "circle",
        "bodyColor": "<string>",
        "animationVariant": "fastest",
        "brows": "<string>",
        "eyes": "<string>",
        "glasses": "<string>",
        "lips": "<string>",
        "nose": "<string>",
        "flip": true,
        "rotate": 123,
        "scale": 123,
        "radius": 123,
        "size": 123,
        "backgroundType": "solid",
        "backgroundRotation": [
          123
        ],
        "translateX": 123,
        "translateY": 123,
        "clip": true,
        "randomizeIds": true
      }
    },
    "background": "blue",
    "empty": true,
    "updatedBy": "dataset:empresas"
  },
  "agentFileId": "<string>",
  "content": {
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "<string>",
          "link": {
            "url": "<string>"
          }
        },
        "annotations": {
          "bold": true,
          "italic": true,
          "strikethrough": true,
          "underline": true,
          "code": true,
          "color": "<string>",
          "trend": "up"
        },
        "plain_text": "<string>",
        "href": "<string>"
      }
    ],
    "color": "<string>"
  },
  "parent": {
    "type": "page_id",
    "page_id": "<string>"
  },
  "usage": {
    "input": 123,
    "output": 123,
    "total": 123,
    "cacheReadInputTokens": 123,
    "cacheCreationInputTokens": 123,
    "cacheCreationEphemeral1hInputTokens": 123,
    "cacheCreationEphemeral5mInputTokens": 123,
    "totalInputTokens": 123,
    "durationSeconds": 123,
    "activeSeconds": 123,
    "claudeUsage": {},
    "claudeStats": {}
  },
  "runSessionId": {
    "object": "session",
    "id": "<string>",
    "status": "provisioning",
    "userId": "<string>",
    "agentVersion": 123
  },
  "url": "<string>"
}

Authorizations

Authorization

string

header

required

OAuth2 Authorization Code flow

Path Parameters

string

required

Page ID

Query Parameters

expand

string

Comma-separated fields to expand. Use "runSessionId.status" for current session status, "runSessionId.userId" for the running user, or "url" for the absolute app URL.

Response

Page found

object

string

required

Object type

Example:

"page"

string

required

Unique identifier

Example:

"p_abc123"

createdAt

string<date-time>

required

Creation timestamp

Example:

"2024-01-15T10:30:00.000Z"

updatedAt

string<date-time>

required

Last update timestamp

Example:

"2024-01-15T14:45:00.000Z"

kind

enum<string>

required

Object kind (report | deal).

Available options:

report,

deal

title

string | null

required

Page title

agent

object

required

Agent reference

Option 1
Option 2

Show child attributes

assignee

object[]

required

Page assignees. Supports users and agents.

Option 1
Option 2

Show child attributes

targets

object[]

required

Page targets

Option 1
Option 2

Show child attributes

permissions

object

required

Show child attributes

files

object[]

required

Show child attributes

pipelines

object

required

Board placements keyed by pipeline id ({ stage, position }). Empty when not on any board.

Show child attributes

properties

object

required

Custom properties (scalar values) keyed by property name. Filter/group via properties.<name>.

relations

object

required

Relation values keyed by relation name (target key or array). Filter via relations.<name>.

summary

string | null

required

createdBy

Created by · object

Principal who created this object

Show child attributes

Example:

{
  "object": "user",
  "id": "u_abc123",
  "apiKeyId": "bsk_abc123"
}

updatedBy

Updated by · object

Principal who last updated this object

Show child attributes

Example:

{
  "object": "user",
  "id": "u_abc123",
  "apiKeyId": "bsk_abc123"
}

icon

object | null

Page icon

Show child attributes

agentFileId

string | null

Source PPTX file ID for the full deck used by this page agent

content

object

Page-level content. Uses the same schema as block.content and renders before child blocks.

Show child attributes

parent

object

Parent relationship (Notion-compatible).

Option 1
Option 2
Option 3
Option 4

Show child attributes

usage

object

Token usage summary for the page

Show child attributes

runSessionId

object | null

Associated page run session reference. Expand runSessionId fields to include run metadata.

Show child attributes

url

string | null

Absolute app URL for the page. Included only when requested with expand=url.

datasets

files

users

pages

people

queries

providers

companies

Company Enrichment

sessions

blocks

agents

entities

lawsuits

scr

changelog

events

search

Feature Store

graph

targets

rules

Get a specific page by ID

Authorizations

Path Parameters

Query Parameters

Response