System Atlas
SystemAtlas

Get an organization

A public registry organization by ref or external id (wikidata:Q95, lei:…, ror:…, cik:…, ein:…, domain:…), summary first with its ids; node, depth and fields drill down, node=sec:links lists its connections and node=sec:sources the sources of its facts. Without a key, names, values and sources below the primitives are withheld, as on the profile page.

GET/api/v1/orgs/:refPublic

Authentication

None. Send a key anyway to get the same answer.

Parameters

Path

  • refstringrequired

    Registry ref, e.g. acme-builders-3f2a9c1d, or an external id such as lei:529900Y25S8NZIYTT924

Query

  • depthnumberoptional

    Levels to expand below the node, 0-4 (default 1)

    ≥ 0≤ 4
  • nodestringoptional

    Handle to expand, from an earlier response: part:hiring, prim:payroll, comp:3f2a9c1d

    max 200 chars
  • fieldsstringoptional

    Keys to keep per item, comma-separated; aliases values, sources, counts, confidence

    max 300 chars
  • limitnumberoptional

    Items per response, 1-200 (the budget may stop earlier)

    ≥ 1≤ 200
  • cursorstringoptional

    next_cursor from the previous response

    max 2000 chars
  • viewenumoptional

    compact (default), full (every field) or v1 (the old shape, unpaged, refused over 64 KB)

    compactfullv1
  • budgetnumberoptional

    Token budget, 200-8000 (default 2000, 6000 for full)

    ≥ 200≤ 8000
  • formatenumoptional

    Old name of view

    compactfullv1

Request

curl "https://systematlas.org/api/v1/orgs/acme-builders-3f2a9c1d?node=prim%3Aestimating&depth=2"

Response

200 with the result in data (abbreviated here). Errors are listed in Errors and limits.

Response
{
  "data": {
    "node": {
      "h": "prim:estimating",
      "l": "Estimating",
      "layer": "process",
      "n": {
        "comps": 1,
        "vals": 2
      }
    },
    "items": [
      {
        "h": "comp:3f2a9c1d",
        "l": "In-house estimating team",
        "layer": "people",
        "conf": "inferred_high",
        "n": {
          "vals": 2
        },
        "items": [
          {
            "h": "val:9c2d41aa",
            "l": "Estimating method",
            "p": "estimating_method",
            "v": "estimating software",
            "s": 0
          }
        ]
      }
    ],
    "src": [
      [
        "https://acmebuilders.example/careers/estimator",
        "Estimator job post"
      ]
    ],
    "hint": "Call get_organization ref=acme-builders-3f2a9c1d with node=comp:3f2a9c1d for its 2 values and sub-components.",
    "tokens": 210
  }
}

Over MCP

The same call as an MCP tool: get_organization.

PreviousVerification of an organizationNext List organizations