noombat API and MCP: read your board from AI and scripts

Quick start

Make a personal key on noombat.ai under Settings, AI apps, then ask for your board's overview. Every answer is JSON.

Request

curl https://noombat.ai/api/v1/board \
  -H "Authorization: Bearer nbk_your_key"

Base address: https://noombat.ai/api/v1/board
OpenAPI 3.1: noombat.ai/api/v1/openapi.json. Sent with your key, it lists your board's own words.
A plain-text guide for AI agents: noombat.ai/api/v1/llms.txt

Your key

A key belongs to one person and one board. No request names a board: the key decides which one it reads, and every request checks again that the person may still see it. Send the key in the Authorization header, never in the address (a key in the address is refused unread).

Keys last 30 or 90 days, or never expire where your organization allows it. You can revoke one at any time on the same page.
Removing someone from the organization, or from the board, ends their keys.
Every request is written to your organization's access log: who, which read, when. Never what was asked or answered.

Connect your AI

The same reads are tools for Claude, ChatGPT, Cursor and VS Code at one address. Claude and ChatGPT ask you to sign in to noombat; the others can send your key instead. Every connection only reads.

Connector address

https://noombat.ai/api/mcp

Claude

claude.ai, and the desktop and phone apps

In Claude, open Customize → Connectors, choose + Add, then Add custom connector.
Name it noombat, paste the connector address and choose Continue. Keep the authentication settings Claude finds and choose Continue again.
Keep Sign in now and Use Claude's published identity (Recommended), then choose Add.
noombat opens. Sign in, pick the board and choose Allow.
In a chat, choose + → Connectors and switch noombat on.

On a Team or Enterprise plan, an owner adds noombat first under Organization settings → Connectors (Add, then Custom, then Web); each person then chooses Connect. Leave Request headers empty: a key there would be shared by everyone who uses the connector. The Free plan allows one custom connector.

ChatGPT

On the web, as a plugin

Go to Plugins (chatgpt.com/plugins), choose the + button, then Add custom MCP server.
Name it noombat and paste the connector address as the Server URL.
For authentication choose OAuth. Read the risk warning, choose I understand and want to continue, then Create as a plugin.
Install noombat from your plugins. When ChatGPT asks, sign in to noombat, pick the board and choose Allow.
In a chat, type @ and pick noombat.

If Add custom MCP server is missing, your ChatGPT plan or workspace does not allow custom servers yet; on a work account, ask whoever runs your ChatGPT workspace. noombat's tools only read, so ChatGPT does not treat them as changes.

A custom GPT

ChatGPT, with a personal key

Create a personal key for the board on noombat.ai under Settings, AI apps.
Open the schema address and copy the whole document.
In the GPT editor, add an action and paste the document as its schema.
Under authentication choose API Key, then Bearer, and paste your key.
Ask the GPT about your board. When ChatGPT asks before calling noombat, you can choose to always allow it: every call only reads.

Schema address

https://noombat.ai/api/v1/openapi.json?for=gpt-actions

Keep this GPT to yourself: everyone who uses it reads your board through your key. Descriptions in this schema are shorter, to fit the lengths GPT actions take.

Claude Code

With a key: no sign-in. Without --header, Claude Code signs you in with the browser (run /mcp).

Terminal

claude mcp add --transport http noombat https://noombat.ai/api/mcp --header "Authorization: Bearer nbk_your_key"

Cursor

In your own ~/.cursor/mcp.json, never in a project's .cursor/mcp.json that goes into git.

~/.cursor/mcp.json

{
  "mcpServers": {
    "noombat": {
      "url": "https://noombat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer nbk_your_key"
      }
    }
  }
}

VS Code

VS Code asks for the key once and keeps it in its own secret storage; the file never holds it.

mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "noombat-key",
      "description": "noombat personal key",
      "password": true
    }
  ],
  "servers": {
    "noombat": {
      "type": "http",
      "url": "https://noombat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:noombat-key}"
      }
    }
  }
}

Claude Code, signed in

No key: Claude Code opens the browser to sign in (run /mcp).

Terminal

claude mcp add --transport http noombat https://noombat.ai/api/mcp

Script

Any HTTP client. The key goes in the header, never in the address.

Terminal

curl https://noombat.ai/api/v1/board \
  -H "Authorization: Bearer nbk_your_key"

Ready-made asks

Apps that show a connector's prompts list these by name. In Claude Code, type /mcp__noombat__ and the prompt's name, then its arguments separated by spaces.

Who to call first call_list: Asks for the companies to call first from the connected noombat board, each with why now (dated, with links), the strongest way in and the opening line.count (optional): How many companies: 5, 10 (the default) or 20.focus (optional): one of the board's groups or client types, by its key or its name.
Brief me on an account account_brief: Asks for a brief on one company from the connected noombat board: what they do, why now, who you know there and through whom, the decision maker, what stands in the way, and how to open.company: The company's name as the board lists it; its first distinctive word or its web domain is enough.
Plan a warm intro intro_plan: Asks for the best warm way into one company on the connected noombat board: each person you can reach, every path to them and its strength, and a short ask to send.company: The company's name as the board lists it; its first distinctive word or its web domain is enough.
Buying signals digest signal_digest: Asks for a summary of the buying signals on the connected noombat board over the last 7, 30 or 90 days, grouped by company, newest first, with dates and links.days (optional): The window: 7, 30 (the default) or 90 days.
Draft personal openers draft_openers: Asks for a short personal opener to each decision maker at one company on the connected noombat board, or at the companies to call first, built only from the board's facts (why now with its date and link, why they fit, the opener the board suggests) and your own positioning, each draft followed by the facts it uses and their links.company (optional): one company, by its name as the board lists it; its first distinctive word or its web domain is enough. Without it, the companies to call first.count (optional): Without a company, how many companies to call first: 3, 5 (the default) or 10.channel (optional): linkedin (the default): a connection note under 200 characters, which fits every LinkedIn account; email: a subject line and three short sentences.

Recipes

Personal openers

Connect noombat to Claude or ChatGPT (above).
Tell your assistant once what you sell and how you position it, in the same conversation or in a project's instructions.
Run the prompt Draft personal openers. Apps that show a connector's prompts list it under that name; in Claude Code type /mcp__noombat__draft_openers, then a company, or 3, 5 or 10, and linkedin or email (noombat being the name you gave the server). In any app you can also ask in your own words: “Draft a LinkedIn note to each decision maker at Acme Example from my noombat board.”
Each draft lists the facts it uses with their links. Check them, then send from your own tools: noombat never sends anything.

Your board in your own tools

Make a personal key under Settings, AI apps, and keep it in an environment variable, never in the script.
The script pages through the companies with the cursor, reads each company and its people, and writes one JSON line per person: company, why now, opener, name, title and LinkedIn.
It pauses between calls, waits as long as a 429 says before trying again, and keeps each answer's ETag so a second run downloads only what changed.
Use one key per script, so each one has its own budget and can be revoked on its own.

noombat_people.py

#!/usr/bin/env python3
"""Your noombat board as JSON lines: one line per person at each company.

Standard library only. Put your personal key (noombat.ai, Settings, AI apps) in NOOMBAT_KEY, then:
    NOOMBAT_KEY=nbk_... python3 noombat_people.py > people.jsonl
"""
import json, os, random, sys, time
import urllib.error, urllib.parse, urllib.request

BASE = os.environ.get("NOOMBAT_BASE", "https://noombat.ai") + "/api/v1/board"
KEY = os.environ["NOOMBAT_KEY"]
PAUSE = 0.2                     # seconds between calls
CACHE = ".noombat-cache.json"   # each answer with its ETag: an unchanged one comes back as a 304

try:
    with open(CACHE) as f:
        cache = json.load(f)
except (OSError, ValueError):
    cache = {}


def wait_for(headers, fallback):
    """Seconds to wait: Retry-After, else until X-RateLimit-Reset, else the fallback."""
    if headers.get("Retry-After", "").isdigit():
        return int(headers["Retry-After"])
    if headers.get("X-RateLimit-Reset", "").isdigit():
        return max(1, int(headers["X-RateLimit-Reset"]) - int(time.time()))
    return fallback


def pace(headers):
    if headers.get("X-RateLimit-Remaining") == "0":
        time.sleep(wait_for(headers, 1))
    else:
        time.sleep(PAUSE)


def get(path, **params):
    url = BASE + path + ("?" + urllib.parse.urlencode(params) if params else "")
    for attempt in range(8):
        req = urllib.request.Request(url, headers={"Authorization": "Bearer " + KEY, "Accept": "application/json"})
        if url in cache:
            req.add_header("If-None-Match", cache[url]["etag"])
        try:
            with urllib.request.urlopen(req, timeout=60) as res:
                body = json.load(res)
                if res.headers.get("ETag"):
                    cache[url] = {"etag": res.headers["ETag"], "body": body}
                pace(res.headers)
                return body
        except urllib.error.HTTPError as e:
            if e.code == 304:
                pace(e.headers)
                return cache[url]["body"]
            if e.code == 429 or e.code >= 500:
                # wait what the answer says, longer on each try, plus a random second
                seconds = max(wait_for(e.headers, 1), min(60, 2 ** attempt)) + random.random()
                print("waiting %.0f s (%d)" % (seconds, e.code), file=sys.stderr)
                time.sleep(seconds)
                continue
            sys.exit("%d %s" % (e.code, json.load(e).get("message", "")))
    sys.exit("gave up after 8 tries")


def pages(path, **params):
    cursor = None
    while True:
        page = get(path, limit=50, **params, **({"cursor": cursor} if cursor else {}))
        yield from page["items"]
        cursor = page.get("next_cursor")
        if not cursor:
            return


overview = get("")
people = {}
if overview["shape"]["people"]:
    for p in pages("/people"):
        people.setdefault(p["company_id"], []).append(p)

for row in pages("/companies"):
    c = get("/companies/" + urllib.parse.quote(str(row["id"]), safe=""))["company"]
    for p in people.get(c["id"]) or c["doors"]:
        print(json.dumps({
            "company": c["name"],
            "why_now": c["why_now_quoted"],
            "opener": c["opener_quoted"],
            "name": p["name"],
            "title": p.get("title"),
            "linkedin": p.get("linkedin_url"),
        }, ensure_ascii=False))

with open(CACHE, "w") as f:
    json.dump(cache, f)

Terminal

curl "https://noombat.ai/api/v1/board/companies?limit=50" \
  -H "Authorization: Bearer nbk_your_key"

curl "https://noombat.ai/api/v1/board/companies/1001" \
  -H "Authorization: Bearer nbk_your_key"

A weekly why-now digest

Each week, run the prompt Buying signals digest with 7 days (in Claude Code: /mcp__noombat__signal_digest 7).
Or ask in your own words: “Summarise the buying signals on my noombat board from the last 7 days, grouped by company, with dates and links.”
From a script, the same week is one read, newest first:

Terminal

curl "https://noombat.ai/api/v1/board/signals?within_days=7&buying_only=true&limit=50" \
  -H "Authorization: Bearer nbk_your_key"

The reads

Each read answers what the MCP tool of the same name answers, byte for byte. Records carry a link to the board that opens only for a member who may see it.

Board overview

GET/api/v1/board

Describes the one noombat board this connection reads. Use it for the board's own words for groups, reasons, client types, roles, door strengths, seats and signal types, today's date, when the board was last read, how many companies sit in each group, which signal types count as buying, what this board does not hold, which fields are usually empty, and what it cannot answer. It lists no companies or people; search_companies, list_people, list_signals and search do.

MCP tool board_overview

No parameters.

Request

curl "https://noombat.ai/api/v1/board" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "Example board: 4 companies, 3 people, 1 competitor; 3 buying signals in the last 90 days.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "connection": {
    "scopes": [
      "board:read"
    ],
    "can_write": false,
    "expires": null
  },
  "counts": {
    "companies": 4,
    "by_group": [
      {
        "key": "walk_in",
        "label": "Walk-in",
        "hint": "A strong door, plus a second person we know there or a door who is their economic buyer or sales lead.",
        "companies": 1
      },
      {
        "key": "warm",
        "label": "Warm",
        "hint": "We have a warm or strong door here. A walk-in takes a strong door plus a second person we know there, or a door who is their economic buyer…",
        "companies": 0
      }
    ],
    "people": 3,
    "competitors": 1,
    "signals": 5,
    "buying_signals_90d": 3
  },
  "vocabulary": {
    "groups": [
      {
        "key": "walk_in",
        "label": "Walk-in",
        "hint": "A strong door, plus a second person we know there or a door who is their economic buyer or sales lead."
      },
      {
        "key": "warm",
        "label": "Warm",
        "hint": "We have a warm or strong door here. A walk-in takes a strong door plus a second person we know there, or a door who is their economic buyer…"
      }
    ],
    "reasons": [
      {
        "key": "raised_idle",
        "label": "Raised, not spending yet",
        "hint": "A round 2 to 12 months ago. Since then: no ads found or a late first ad, 1 GTM role open at most, and at most 1 in 10 sellers new."
      },
      {
        "key": "new_leader",
        "label": "New leader",
        "hint": "A new head of sales, marketing, revenue or the company in the last 90 days."
      }
    ],
    "segments": [
      {
        "key": "in_book",
        "label": "Attio category: Client",
        "hint": "Attio files them under a client category: Growth, Scale-up or Enterprise. A category, not a paying client: `customer` says who pays."
      },
      {
        "key": "candidate",
        "label": "Good fit",
        "hint": "Right size, location and industry, and nothing about how they sell has put them in doubt."
      }
    ],
    "roles": [
      {
        "key": "buyer",
        "label": "Company",
        "hint": "A company on the list."
      },
      {
        "key": "rival",
        "label": "Competitor",
        "hint": "A company the Competitors tab names as a competitor. It stays on the list, tagged."
      }
    ],
    "door_kinds": [
      {
        "key": "strong",
        "label": "Strong door",
        "hint": "How well the partner knows them and where they sit add up to 65 points or more."
      },
      {
        "key": "warm",
        "label": "Warm door",
        "hint": "40 to 64 points: how well the partner knows them and where they sit."
      }
    ],
    "seat_classes": [],
    "signal_types": [
      {
        "key": "tools",
        "label": "Website tools",
        "hint": "The sales and marketing tools their website carries, and the month each one first appeared.",
        "reason": null,
        "group": "team",
        "signal_group": "buying",
        "reason_label": null,
        "signal_group_label": "A change worth a call"
      },
      {
        "key": "hiring",
        "label": "Hiring",
        "hint": "Open sales and marketing roles, and whether a CMO, CRO or VP role is among them.",
        "reason": null,
        "group": "team",
        "signal_group": "buying",
        "reason_label": null,
        "signal_group_label": "A change worth a call"
      }
    ],
    "signal_groups": [
      {
        "key": "buying",
        "label": "A change worth a call",
        "hint": "A round, a deal, a new country, ads, a GTM hire or tool, or a visit to our website: a reason to reach out now."
      },
      {
        "key": "warmth",
        "label": "People we know",
        "hint": "Someone we know started a new role there or left it: a way in may have changed."
      }
    ]
  },
  "shape": {
    "doors": "intro_paths",
    "doors_label": "People the partners know there, through their LinkedIn books",
    "people": true,
    "competitors": true,
    "seats": false,
    "worked_beside": false,
    "linkedin_profiles": true,
    "marks": true,
    "not_on_board": [
      "company.founded",
      "company.added"
    ]
  },
  "usually_empty": {
    "company": [
      "why_now_quoted",
      "description_quoted"
    ],
    "person": []
  },
  "definitions": {
    "priority": "Priority is the number on the left of the list: 0 to 100 fit points from their sales and marketing team and the tools on their website. The…",
    "fresh": "A why-now chip shows only while its facts are recent, each in its own window: a round 2 to 12 months ago, a new leader in the last 90 days,…",
    "door": "A door is someone in our contacts, the partners' LinkedIn books, who works at the company now, used to work there, or sits on its board. Ea…",
    "groups": "Each company sits in the tier of its best way in: Walk-in, Warm, Faint, Via a contact only, No door found, or Haven't looked yet. The list …",
    "signals": "A signal is a dated change at a company, from the Signals feed: website tools, hiring, team size, filings, rounds, M&A, a new country, ads,…",
    "quoted": "Fields ending in _quoted are text copied from public web pages, shown as written (cleaned, cut at 400 characters).",
    "buying": "A buying signal is a dated page or event of a type this board classes as buying (vocabulary.signal_types, signal_group buying): a reason to…",
    "product_use": "A product_use signal is a current noombat client's own people using noombat (a visit from their own dashboard). It is never a buying signal…",
    "signs": "signs is true when one of our doors at the company reaches the economic buyer, the person who signs. This board has no seats on its People …",
    "priority_scale": "Fit points from 0 to 100, from their sales and marketing team and the tools on their website; timing only breaks ties. A company not read y…",
    "person_priority_scale": "The points of their strongest way in (their lead strong or warm door, engagement left out), held between 0 and 100; someone with no strong …"
  },
  "cannot_answer": [
    "Anything about a company or a person that is not on this board, and anything on another noombat board: this connection reads this board onl…",
    "Every way in at a company past its 25 strongest doors, and faint doors beside a warm or strong one: the full list is in its company file on…"
  ],
  "catalog_version": "2.0.0"
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 429 rate_limited, 500 internal, 503 unavailable

Search the board

GET/api/v1/board/search

Finds companies, people and competitors on the connected noombat board by name or web domain, and returns at most 10 matches as id, title and link. Use it to turn a name the user mentions into an id: fetch takes it as it is (company:<id>, person:<id>, competitor:<id>), and so do get_company, get_person and get_competitor. It does not filter or rank by priority; search_companies does.

MCP tool search

ParameterTypeWhat it does

queryquery, requiredtextA company's, person's or competitor's name, or a company's web domain, in part or whole (case and accents ignored).

Request

curl "https://noombat.ai/api/v1/board/search?query=Acme" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "results": [
    {
      "id": "company:1001",
      "title": "Acme Test SRL, acme.example (company, Walk-in)",
      "url": "https://noombat.ai/open/acme/acme-gtm/company/1001"
    }
  ]
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 429 rate_limited, 500 internal, 503 unavailable

Search companies

GET/api/v1/board/companies

Lists companies on the connected board, in the board's own order by default (what to do first, then Priority: 0–100 points, never a probability). Filters: name or domain text, group, reason, client type, role, a door (someone you know there), door_strength (at least this strong), signs, worked beside you, signal types, buying signals within N days. Use it for 'who do I call first', 'who has a warm way in' or 'who showed buying signals lately'. Row fields: priority_top, the line adding most; door_count counts people; best_door, the first door or, with signs true, the strongest signer, via: everyone on your side who knows them; signing_doors, up to 3 signers (compact: if 2+; signing_door_count counts them, signing_note when none is named); customer_label, what customer rests on; group is the to-do order, not payment or acquaintance. get_company returns the whole file. Pages of up to 50 with a cursor; the summary says what is left and, if empty, how many match without each filter.

MCP tool search_companies · pages of 20 rows, 50 at most

ParameterTypeWhat it does

queryquerytextText the company's name or web domain contains (case and accents ignored).

groupqueryone of this board's wordsThe board's own group, in its order (what to do first); a group is not whether you know someone there, which has_door says.

reasonqueryone of this board's wordsA reason on the company's reason chip.

segmentqueryone of this board's wordsThe company's client type.

rolequeryone of this board's wordsWhat the company is to you.

has_doorquerytrue or falsetrue: at least one door, someone you know there who counts as a way in (the usual meaning of "a warm way in"); false: none.

door_strengthqueryone of this board's wordsA door of this kind or a stronger one (at least this strong); the kinds, strongest first.

signsquerytrue or falsetrue: one of the company's doors sits in the seat that signs (the row's signs flag); false: none does. One row per company.

worked_beside_mequerytrue or falseWhether someone you know there worked with you.

buying_within_daysquerywhole number, 1 to 365Has a buying signal dated within this many days of today (1–365).

signal_typesquerylist, the parameter repeated (1 to 10): each one of this board's wordsHas a signal of any of these types.

sortqueryone of priority, latest_buying_signal, latest_signal, namepriority = the board's order, what to do first then Priority (the default); latest_buying_signal = the newest buying signal first; latest_signal = the same as latest_buying_signal, kept for older callers; name = A to Z.

detailqueryone of compact, standardcompact (the default): each row's essentials; standard: more fields per row. standard adds industry, size, city, country, signs, worked beside you, fresh reasons and the next step.

limitquerywhole number, 1 to 50Rows per page, 20 by default, 50 at most.

cursorquerytextnext_cursor of the previous page, with the same filters; the page keeps that page's detail unless detail is given.

Request

curl "https://noombat.ai/api/v1/board/companies?limit=2" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "2 of 4 companies, ordered by what to do first, then Priority. 2 more after this page, through next_cursor.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "total": 4,
  "offset": 0,
  "returned": 2,
  "next_cursor": "djEuMi4wOWI1OWNkNWM4MDcwZTZlLmJkMzk0NDg2ODQyYjVhY2EuYw",
  "trimmed": false,
  "applied": [],
  "items": [
    {
      "id": "1001",
      "name": "Acme Test SRL",
      "domain": "acme.example",
      "group": "walk_in",
      "group_label": "Walk-in",
      "priority": 64,
      "priority_top": null,
      "why_now_quoted": "New leader, Sep",
      "reasons": [
        "new_leader"
      ],
      "reason_labels": [
        "New leader"
      ],
      "latest_buying_signal": "2026-08-01",
      "latest_signal": "2026-09-20",
      "door_count": 2,
      "best_door": {
        "name": "Person A",
        "seat": null,
        "strength": "strong",
        "strength_label": "Strong door",
        "via": [
          "Mara",
          "Lia"
        ]
      },
      "signs": false,
      "customer": false,
      "customer_label": "Not a customer on record",
      "segment": "candidate",
      "segment_label": "Good fit",
      "role": "buyer",
      "role_label": "Company"
    },
    {
      "id": "c_308c6674e3bccda4ee67",
      "name": "Gamma Test AG",
      "domain": "gamma.example",
      "group": "via",
      "group_label": "Via a contact only",
      "priority": null,
      "priority_note": "Team not read yet",
      "priority_top": null,
      "why_now_quoted": null,
      "reasons": [],
      "reason_labels": [],
      "latest_buying_signal": null,
      "latest_signal": null,
      "door_count": 0,
      "best_door": {
        "name": "Person C",
        "seat": null,
        "strength": "via",
        "strength_label": "Via a contact",
        "via": [
          "Dan"
        ]
      },
      "signs": false,
      "customer": false,
      "customer_label": "Not a customer on record",
      "segment": "candidate",
      "segment_label": "Good fit",
      "role": "buyer",
      "role_label": "Company"
    }
  ]
}

Errors: 400 bad_argument, 400 bad_cursor, 401 invalid_key, 403 access_denied, 429 rate_limited, 500 internal, 503 unavailable

Get a company

GET/api/v1/board/companies/{id}

Returns one company's full file from the connected board, by id (search's company:<id> works too) or by name: profile (website, LinkedIn page, industry, size, city, country, founded, description), its group and the lines behind its Priority, why now, reasons with their labels, what stands in the way, the opening line, facts, the people you know there who are a way in (each person once, every path to them in via), the people on the People tab there, its newest dated signals with links, whether it is a paying client (customer_label says on what basis), a link to it on the board, and which fields are not on record. Use it to brief on one account or to answer 'who do I know at X and through whom'.

MCP tool get_company

ParameterTypeWhat it does

idin the path, requiredtextA company id from search_companies or list_people, or search's company:<id>.

Request

curl "https://noombat.ai/api/v1/board/companies/1001" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "Acme Test SRL: Walk-in, priority 64, 2 doors.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "company": {
    "id": "1001",
    "name": "Acme Test SRL",
    "domain": "acme.example",
    "website": "https://acme.example/",
    "linkedin_url": "https://www.linkedin.com/company/1001/",
    "links": {
      "board_url": "https://noombat.ai/open/acme/acme-gtm/company/1001",
      "website": "https://acme.example/",
      "linkedin_url": "https://www.linkedin.com/company/1001/"
    },
    "industry": "IT services",
    "employees": 180,
    "city": "Bucharest",
    "country": "Romania",
    "founded": null,
    "added": null,
    "group": "walk_in",
    "group_label": "Walk-in",
    "priority": {
      "score": 64,
      "title": "Turnkey",
      "text": "64 points: turnkey, moving now.",
      "step": null,
      "lines": [],
      "scale": "Fit points from 0 to 100, from their sales and marketing team and the tools on their website; timing only breaks ties. A company not read y…"
    },
    "why_now_quoted": "New leader, Sep",
    "reasons": [
      "new_leader"
    ],
    "reason_labels": [
      "New leader"
    ],
    "fresh_reasons": [
      "new_leader"
    ],
    "segment": "candidate",
    "segment_label": "Good fit",
    "role": "buyer",
    "role_label": "Company",
    "in_the_way": null,
    "opener_quoted": null,
    "description_quoted": "Acme Test SRL builds test robots for factories, sold through a field team.",
    "facts": [
      {
        "label": "Way in",
        "value": "Walk-in. A strong door, plus a second person we know there or a door who is their economic buyer or sales lead."
      },
      {
        "label": "Ways in",
        "value": "2 different people with a warm or strong door (door_count). Counted by path, one per partner who knows someone there and faint doors includ…"
      }
    ],
    "doors": [
      {
        "name": "Person A",
        "title": "Head of Sales there since dates unknown",
        "seat": null,
        "strength": "strong",
        "note": "Through Mara. Connected with Mara; no date on LinkedIn.",
        "person_id": "p_79709a656b5716dc2ece",
        "linkedin_url": "https://www.linkedin.com/in/person-a-123/",
        "via": [
          {
            "partner": "Mara",
            "seat": null,
            "strength": "strong",
            "note": "Connected with Mara; no date on LinkedIn.",
            "strength_label": "Strong door"
          },
          {
            "partner": "Lia",
            "seat": null,
            "strength": "warm",
            "note": "Their own best door here.",
            "strength_label": "Warm door"
          }
        ],
        "strength_label": "Strong door",
        "seat_class": null,
        "seat_class_label": null,
        "signs": false
      },
      {
        "name": "Person B",
        "title": "VP Marketing there since Mar 2022",
        "seat": null,
        "strength": "warm",
        "note": "Through Dan: their own best door here.",
        "person_id": null,
        "linkedin_url": null,
        "via": [
          {
            "partner": "Dan",
            "seat": null,
            "strength": "warm",
            "note": "Their own best door here.",
            "strength_label": "Warm door"
          }
        ],
        "strength_label": "Warm door",
        "seat_class": null,
        "seat_class_label": null,
        "signs": false
      }
    ],
    "door_count": 2,
    "doors_listed": 2,
    "doors_note": "Each door is listed once, strongest first, the company's best way in first, every partner's path in via (via.partner is the partner whose L…",
    "signs": false,
    "worked_beside_you": null,
    "evidence_count": 2,
    "signals": [
      {
        "company_id": "1001",
        "type": "moves",
        "label": "People moves",
        "reason": null,
        "group": "people",
        "signal_group": "warmth",
        "date": "2026-09-20",
        "date_note": "found",
        "date_confidence": 0.2,
        "text_quoted": "Someone we know started a new role here, or left one.",
        "url": null,
        "source": null,
        "reason_label": null,
        "group_label": "People",
        "signal_group_label": "People we know",
        "date_note_label": "The page gives no date: the day it was found"
      },
      {
        "company_id": "1001",
        "type": "rounds",
        "label": "Funding rounds",
        "reason": null,
        "group": "money",
        "signal_group": "buying",
        "date": "2026-08-01",
        "date_note": null,
        "date_confidence": 1,
        "text_quoted": "They raised a round.",
        "url": "https://news.example/acme-round",
        "source": "Example News",
        "reason_label": null,
        "group_label": "Money",
        "signal_group_label": "A change worth a call",
        "date_note_label": null
      }
    ],
    "signals_total": 2,
    "latest_signal": "2026-09-20",
    "latest_buying_signal": "2026-08-01",
    "customer": false,
    "customer_label": "Not a customer on record",
    "customer_basis": null,
    "not_on_record": [],
    "people": [
      {
        "id": "p_79709a656b5716dc2ece",
        "name": "Person A",
        "title": "Head of Sales",
        "seat": "Strong door",
        "seat_class": null,
        "seat_class_label": null,
        "priority": 72
      },
      {
        "id": "p_1f5b49d5281b562b991d",
        "name": "Person M",
        "title": "Head of Sales",
        "seat": "No way in yet",
        "seat_class": null,
        "seat_class_label": null,
        "priority": null,
        "priority_note": "No way in yet"
      }
    ]
  },
  "trimmed": false
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 404 not_found, 429 rate_limited, 500 internal, 503 unavailable

List people

GET/api/v1/board/people

Lists the People tab of the connected board: people at the companies on the list, with their seat in the sale and its class (with its label), Priority, LinkedIn profile, whether they are a door (is_door: someone you know who counts as a way in) and the first reason they matter. The summary says how many people the People tab holds; get_company's doors list the people known at a company. With company_id at a company the People tab holds nobody at, the answer carries that company's doors (doors) and no rows. Filters: name, title or company text, a company id, the company's group, a seat class, the seat that signs (signing_seat_only counts people, and one company can have several), and doors only (known_only). Use it to find the decision maker at a company or the people to approach this week; get_person returns one person's whole read. Pages of up to 50 with a cursor; the summary counts people and the companies they work at.

MCP tool list_people · pages of 20 rows, 50 at most · only on boards that hold this part

ParameterTypeWhat it does

queryquerytextText the person's name, title or company name contains.

company_idquerytextOnly people at this company.

groupqueryone of this board's wordsTheir company's group.

seat_classqueryone of this board's wordsTheir seat in the sale.

signing_seat_onlyquerytrue or falseOnly people in the seat that signs (seat_class decides), known or not; it counts people, and one company can have several (the summary gives both counts).

known_onlyquerytrue or falseOnly people who are a door at their company (someone you know who counts as a way in); each row's is_door says the same.

sortqueryone of priority, namepriority = the board's order (the default); name = A to Z.

detailqueryone of compact, standardcompact (the default): each row's essentials; standard: more fields per row. standard adds why they lean in now, location, country and seniority.

limitquerywhole number, 1 to 50Rows per page, 20 by default, 50 at most.

cursorquerytextnext_cursor of the previous page, with the same filters; the page keeps that page's detail unless detail is given.

Request

curl "https://noombat.ai/api/v1/board/people?limit=2" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "2 of 3 people at 2 companies, ordered by Priority. The People tab holds 3 people. 1 more after this page, through next_cursor.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "total": 3,
  "offset": 0,
  "returned": 2,
  "next_cursor": "djEuMi44YWU5ZGVhNDA2YjQ3NzdkLmJkMzk0NDg2ODQyYjVhY2EuYw",
  "trimmed": false,
  "items": [
    {
      "id": "p_79709a656b5716dc2ece",
      "name": "Person A",
      "title": "Head of Sales",
      "company_id": "1001",
      "company_name": "Acme Test SRL",
      "company_group": "walk_in",
      "company_group_label": "Walk-in",
      "seat": "Strong door",
      "seat_class": null,
      "seat_class_label": null,
      "is_door": true,
      "priority": 72,
      "linkedin_url": "https://www.linkedin.com/in/person-a-123/",
      "why_quoted": "Mara knows them well."
    },
    {
      "id": "p_c1f4c48f6a8b6053e3d9",
      "name": "Person C",
      "title": "Head of Sales",
      "company_id": "c_308c6674e3bccda4ee67",
      "company_name": "Gamma Test AG",
      "company_group": "via",
      "company_group_label": "Via a contact only",
      "seat": "In our contacts",
      "seat_class": null,
      "seat_class_label": null,
      "is_door": true,
      "priority": null,
      "priority_note": "No number yet",
      "linkedin_url": "https://www.linkedin.com/in/person-c/",
      "why_quoted": "Mara knows them well."
    }
  ]
}

Errors: 400 bad_argument, 400 bad_cursor, 401 invalid_key, 403 access_denied, 404 not_found, 404 not_on_board, 429 rate_limited, 500 internal, 503 unavailable

Get a person

GET/api/v1/board/people/{id}

Returns one person from the People tab of the connected board, by id or by name (with an optional company id to tell two people apart): title, headline, location, LinkedIn profile, seat in the sale, the lines behind their Priority, why they matter now, career, their own recent LinkedIn posts the board holds, the suggested opening line, a link to them on the board, and which fields are not on record. Use it before writing to or calling someone.

MCP tool get_person · only on boards that hold this part

ParameterTypeWhat it does

idin the path, requiredtextA person id from list_people or a company's doors (person_id), or search's person:<id>.

Request

curl "https://noombat.ai/api/v1/board/people/p_79709a656b5716dc2ece" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "Person A, Head of Sales at Acme Test SRL: Strong door, priority 72.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "person": {
    "id": "p_79709a656b5716dc2ece",
    "name": "Person A",
    "title": "Head of Sales",
    "headline_quoted": "Head of Sales at Acme Test SRL",
    "location": "Cluj, Romania",
    "country": null,
    "company_id": "1001",
    "seat": {
      "label": "Strong door",
      "class": null,
      "class_label": null
    },
    "seniority": null,
    "priority": {
      "score": 72,
      "lines": [],
      "scale": "The points of their strongest way in (their lead strong or warm door, engagement left out), held between 0 and 100; someone with no strong …"
    },
    "why": [
      {
        "text_quoted": "Mara knows them well.",
        "date": null,
        "url": null,
        "company_id": null
      },
      {
        "text_quoted": "Leads sales at Acme Test SRL.",
        "date": null,
        "url": null,
        "company_id": null
      }
    ],
    "leaning_in_quoted": "They reacted to us",
    "career": [
      {
        "title": "Head of Sales",
        "company": "Acme Test SRL",
        "from": "2021-03-01",
        "to": null
      }
    ],
    "posts": null,
    "opener": null,
    "linkedin_url": "https://www.linkedin.com/in/person-a-123/",
    "links": {
      "board_url": "https://noombat.ai/open/acme/acme-gtm/person/p_79709a656b5716dc2ece",
      "linkedin_url": "https://www.linkedin.com/in/person-a-123/"
    },
    "not_on_record": [],
    "company": {
      "id": "1001",
      "name": "Acme Test SRL",
      "group": "walk_in",
      "group_label": "Walk-in",
      "company_why": []
    }
  },
  "trimmed": false
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 404 not_found, 404 not_on_board, 429 rate_limited, 500 internal, 503 unavailable

List signals

GET/api/v1/board/signals

Lists dated public pages and events about the companies on the connected board, newest first: what happened, its type and class (buying, warmth, context, in the way, or a client using noombat), the date, how many days ago and how sure it is, the page's line and its link; the summary counts the signals and the companies they are about. Filters: one or more types, types to leave out, a class, buying signals only, a reason, a company, and a date window (since/until or the last N days). Use it for 'what changed recently' or 'who raised money'. A company's reasons (its why-now chip, a new leader for one) are company fields that search_companies' reason filter finds; reason here keeps the signals a board files under a reason. Pages of up to 50 with a cursor.

MCP tool list_signals · pages of 20 rows, 50 at most

ParameterTypeWhat it does

typesquerylist, the parameter repeated (1 to 10): each one of this board's wordsOnly these signal types.

exclude_typesquerylist, the parameter repeated (1 to 10): each one of this board's wordsLeave out these signal types.

signal_groupqueryone of buying, warmth, context, in_the_way, product_useOnly signals of this class: buying; warmth; context; in_the_way; product_use.

buying_onlyquerytrue or falseOnly buying signals: the same as signal_group buying.

reasonqueryone of this board's wordsThis board files no signal type under a reason, so this matches no signal; search_companies' reason filter lists the companies whose reason chip shows one.

company_idquerytextOnly this company's signals.

sincequeryday (YYYY-MM-DD)Only signals dated on or after this day (YYYY-MM-DD).

untilqueryday (YYYY-MM-DD)Only signals dated on or before this day (YYYY-MM-DD).

within_daysquerywhole number, 1 to 365Only signals dated within this many days of today (1–365); not together with since.

typequeryone of this board's wordsDeprecated: one signal type, the same as types with one entry.

limitquerywhole number, 1 to 50Rows per page, 20 by default, 50 at most.

cursorquerytextnext_cursor of the previous page, with the same filters.

Request

curl "https://noombat.ai/api/v1/board/signals?limit=2" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "2 of 5 signals about 3 companies, newest first. 3 more after this page, through next_cursor.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "total": 5,
  "offset": 0,
  "returned": 2,
  "next_cursor": "djEuMi45ZDcwZGYzMjM0M2RmMjQ4LmJkMzk0NDg2ODQyYjVhY2E",
  "trimmed": false,
  "items": [
    {
      "company_name": "Delta Test GmbH",
      "company_id": "1004",
      "type": "visits",
      "label": "Using noombat",
      "reason": null,
      "group": null,
      "signal_group": "product_use",
      "date": "2026-10-02",
      "date_note": null,
      "date_confidence": 1,
      "text_quoted": "Someone from here visited our website: their people use noombat, so it is not a reason to call.",
      "url": null,
      "source": "noombat.ai",
      "reason_label": null,
      "group_label": null,
      "signal_group_label": "Using noombat",
      "date_note_label": null,
      "days_ago": 5
    },
    {
      "company_name": "Acme Test SRL",
      "company_id": "1001",
      "type": "moves",
      "label": "People moves",
      "reason": null,
      "group": "people",
      "signal_group": "warmth",
      "date": "2026-09-20",
      "date_note": "found",
      "date_confidence": 0.2,
      "text_quoted": "Someone we know started a new role here, or left one.",
      "url": null,
      "source": null,
      "reason_label": null,
      "group_label": "People",
      "signal_group_label": "People we know",
      "date_note_label": "The page gives no date: the day it was found",
      "days_ago": 17
    }
  ]
}

Errors: 400 bad_argument, 400 bad_cursor, 401 invalid_key, 403 access_denied, 404 not_found, 429 rate_limited, 500 internal, 503 unavailable

List competitors

GET/api/v1/board/competitors

Lists the Competitors tab of the connected board as compact rows: your own row as the benchmark, then each picked competitor with how hard they press on your buyers (and the parts of that number), how you win against them, their reach, how many companies on your list name them, and their latest dated move. Use it to see the field; get_competitor returns one competitor's whole read (leaders, what they post about, engagement from your list).

MCP tool list_competitors · only on boards that hold this part

ParameterTypeWhat it does

detailqueryone of compact, standardcompact (the default): one short row per competitor; standard: every competitor's whole read, as get_competitor returns it.

Request

curl "https://noombat.ai/api/v1/board/competitors" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "Your own row and 1 of 1 competitor.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "you": {
    "id": "noombat-self",
    "name": "noombat Example",
    "domain": "noombat.ai",
    "is_you": true,
    "compete": "direct",
    "compete_label": "Sells the same thing",
    "pressure": null,
    "pressure_parts": null,
    "how_you_win": "We read both books.",
    "followers": null,
    "on_board_count": 0,
    "latest": {
      "text_quoted": "Launched a new plan",
      "date": "2026-09-15"
    },
    "signal_count": 1
  },
  "competitors": [
    {
      "id": "rivalco",
      "name": "RivalCo Example",
      "domain": "rivalco.example",
      "is_you": false,
      "compete": "direct",
      "compete_label": "Sells the same thing",
      "pressure": 41,
      "pressure_parts": {
        "pull": 10,
        "push": 12,
        "overlap": 15,
        "retreat": 4
      },
      "how_you_win": "We read both books.",
      "followers": null,
      "on_board_count": 1,
      "latest": {
        "text_quoted": "Launched a new plan",
        "date": "2026-09-15"
      },
      "signal_count": 1
    }
  ],
  "total": 1,
  "returned": 1,
  "trimmed": false
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 404 not_on_board, 429 rate_limited, 500 internal, 503 unavailable

Get a competitor

GET/api/v1/board/competitors/{id}

Returns one competitor's full read from the connected board, by id or name: what they sell and lead with, ownership, size, stage, pressure on your buyers, social reach and post mix, engagement from people on your list, their leaders and themes, hiring, the companies on your list that name them, how you win, their latest dated move, a link to them on the board, and which fields are not on record.

MCP tool get_competitor · only on boards that hold this part

ParameterTypeWhat it does

idin the path, requiredtextA competitor id from list_competitors, or search's competitor:<id>.

Request

curl "https://noombat.ai/api/v1/board/competitors/rivalco" \
  -H "Authorization: Bearer nbk_your_key"

Example answer (a made-up board, two rows per list)

200 OK, application/json

{
  "summary": "RivalCo Example: pressure 41, named by 1 company on your list.",
  "board": "Example board",
  "today": "2026-10-06",
  "as_of": {
    "computed": "2026-10-04",
    "signals_checked": "2026-10-05",
    "people_read": "2026-10-05",
    "competitors_read": "2026-09-30"
  },
  "competitor": {
    "id": "rivalco",
    "is_you": false,
    "name": "RivalCo Example",
    "domain": "rivalco.example",
    "website": "https://rivalco.example/",
    "linkedin_url": "https://www.linkedin.com/company/rivalco-example/",
    "compete": "direct",
    "leads_with_quoted": "this board at scale",
    "owned_by": null,
    "employees": 40,
    "hq": "London, UK",
    "stage": "series_a",
    "pressure": {
      "score": 41,
      "pull": 10,
      "push": 12,
      "overlap": 15,
      "retreat": 4
    },
    "social": null,
    "buyers": null,
    "engagement": null,
    "leaders": [
      {
        "name": "Person L",
        "title": "CEO",
        "since": "2020-01-01",
        "posts_per_week": 2,
        "themes": [
          "product"
        ]
      }
    ],
    "hiring_open": 3,
    "joined_90": 2,
    "left_90": 1,
    "on_board": [
      {
        "company_id": "1004",
        "name": "Delta Test GmbH"
      }
    ],
    "customers_named": 0,
    "what_they_sell": null,
    "what_they_sell_quoted": "Intro software",
    "how_you_win": "We read both books.",
    "latest": {
      "text_quoted": "Launched a new plan",
      "date": "2026-09-15",
      "url": "https://rivalco.example/news"
    },
    "signal_count": 1,
    "compete_label": "Sells the same thing",
    "stage_label": "series_a",
    "links": {
      "board_url": "https://noombat.ai/open/acme/acme-gtm/competitor/rivalco",
      "website": "https://rivalco.example/",
      "linkedin_url": "https://www.linkedin.com/company/rivalco-example/"
    },
    "not_on_record": [
      "owned_by",
      "social"
    ]
  },
  "trimmed": false
}

Errors: 400 bad_argument, 401 invalid_key, 403 access_denied, 404 not_found, 404 not_on_board, 429 rate_limited, 500 internal, 503 unavailable

Parameters and pages

Parameter names are the tool's own. A list is the parameter repeated: types=funding&types=new_leader. Booleans are true or false, days YYYY-MM-DD.
An unknown, empty or doubled parameter is refused with a 400, never ignored.
Where a parameter takes one of your board's words (its groups, reasons, signal types), the overview lists them under vocabulary, each with its label. The OpenAPI document sent with your key lists them too.
Lists answer total, returned, items and next_cursor. The next page is the same request with cursor added; the Link header carries it too.
Every answer has an ETag. Send it back in If-None-Match and an unchanged answer comes back as a 304 with no body.
Fields ending in _quoted hold text copied from public web pages: quotes, not statements by noombat or by you. An empty field means the board holds nothing there; records list those under not_on_record.

Limits

Per key or connection: 20 requests a second, 600 a minute, 100,000 a day
Per person, per board: 1,200 a minute, 200,000 a day, across all their keys and AI apps
Per network address: a backstop for apps that share one address: 6,000 requests a minute that carry a key or a connection, 600 without; after 60 refused keys in a minute, a malformed key gets a 429 (a well-formed key is always checked, so a valid one is never refused for someone else's mistakes)
Windows: each second, each minute and each day (UTC) on the clock; a budget frees in full when its window ends, and refused requests count too
In force: the limits in force are always the ones each answer's RateLimit-Policy header names; go by the headers, not by this page
Page size: 20 rows by default, 50 at most; next_cursor continues with the same parameters
Answer size: at most 30,000 characters; a longer list is trimmed (trimmed: true, and the summary says so) and the cursor continues
Address: at most 4,096 characters; GET only, no body
Keys: at most 5 live keys per person per board; 30 or 90 days, or never where the organization allows it

Headers

RateLimit-Policy: Every budget the request spends: its name, q (requests) and w (the window in seconds).
RateLimit: The budget with the fewest requests left: r (requests left) and t (seconds until its window ends).
X-RateLimit-Limit: That budget's size.
X-RateLimit-Remaining: Requests left in it.
X-RateLimit-Reset: When its window ends, in seconds since 1970 (UTC).
Retry-After: On a 429 only: seconds to wait. The body says the same in retry_after_s and in words.

On a 429

Wait the seconds Retry-After says, then send the request again.
If it is refused again, wait longer each time (1, 2, 4, 8 seconds and so on, up to a minute), adding a random fraction of a second so that several scripts do not retry together. Stop after a few tries.
Pace yourself before you get there: when X-RateLimit-Remaining reaches 0, wait until X-RateLimit-Reset.
Give each script its own key: each key has its own budget, and you can revoke one without stopping the others. Your keys and AI apps on one board still share your per-person budget.

Errors

Errors are RFC 9457 problem details (application/problem+json). The fields error (a code) and message (plain words) are always there. Nothing you sent is ever repeated back.

400bad_argumentBad argument

A parameter is unknown, sent twice, empty, of the wrong type, or not one of this board's words. The answer names our own parameter (field) and, for a word list, the words this board takes (allowed); never the value sent.

Correct the request.

400bad_argumentCursor not valid

The cursor belongs to another query, or the board has changed since it was made.

Start again without cursor.

401invalid_keyInvalid key

No key, a key that is not one of ours, or one that has expired or was revoked. The answer carries WWW-Authenticate: Bearer realm="noombat".

Send a live personal key in the Authorization header.

403access_deniedAccess denied

The key's person may not read this board now: their membership or project changed, the board was switched off for AI apps, the organization switched AI access off, or the key may not read.

Ask an admin of the board's organization. Removing someone from the board ends their keys, so they make a new one once access is back.

404not_foundNot found

No such read at this address, or no record with this id on this board. Ids may change when the board is rebuilt.

Find the record again with /search or a list.

404not_on_boardNot on this board

This board does not hold what the read lists (for example, a board without a Competitors tab).

The overview says what the board holds.

405method_not_allowedMethod not allowed

The API only reads: every method but GET is refused, before anything is read.

Send a GET.

413too_largeRequest too large

A GET with a body, or an address over 4,096 characters.

Send fewer or shorter parameters.

421misdirectedMisdirected request

The request reached another host name than noombat.ai.

Send it to https://noombat.ai.

429rate_limitedRate limited

A budget ran out (see Limits). Retry-After and retry_after_s say when the full window frees.

Wait that long, then send again.

500internalInternal error

Something failed on our side. Nothing about it is sent.

Send again later.

503unavailableUnavailable

The API is switched off, or the board or a check could not be read just now.

Send again in a minute.

Versions

This is version 2.0.0. New reads, fields and parameters arrive without notice and never break a script. A change that would break one keeps the old form for at least 90 days and says so in a Deprecation header.

The board API

Quick start

Your key

Connect your AI

Claude

ChatGPT

A custom GPT

Claude Code

Cursor

VS Code

Claude Code, signed in

Script

Ready-made asks

Recipes

Personal openers

Your board in your own tools

A weekly why-now digest

The reads

Board overview

Search the board

Search companies

Get a company

List people

Get a person

List signals

List competitors

Get a competitor

Parameters and pages

Limits

Headers

On a 429

Errors

Versions