entities | GraphQL reference

entities

returns [LedgerEntity!]!

List entities for a graph, optionally filtered by source.

Arguments

Name	Type	Description
source	String	Filter by the system an entity came from, e.g. `quickbooks`.

Returns LedgerEntity

Entity details from the extensions OLTP database. Returned by entity reads and update-entity. Identifiers (CIK / ticker / SIC / LEI / tax_id) are present when sourced from SEC or registry data; many are null for private companies. The address fields are flattened (no nested object) to make them easy to project into reporting forms.

Field	Type	Description
id	String!	Entity identifier (ULID).
name	String!	Display name shown in UI.
legalName	String	Full registered legal name (when different from `name`).
uri	String	Canonical URL / external identifier.
cik	String	SEC CIK (Central Index Key).
ticker	String	Stock ticker symbol.
exchange	String	Listing exchange (e.g. 'NASDAQ', 'NYSE').
sic	String	SIC industry code.
sicDescription	String	SIC code description.
category	String	Filer category (e.g. 'Large Accelerated Filer').
stateOfIncorporation	String	US state or country of incorporation.
fiscalYearEnd	String	Fiscal year-end as MM-DD (e.g. '12-31', '06-30').
taxId	String	Tax ID (EIN / SSN).
lei	String	Legal Entity Identifier (ISO 17442).
industry	String	Free-form industry label.
entityType	String	Legal form (e.g. 'corporation', 'llc', 'lp').
reportingStyleId	String	Active Reporting Style (Structure id) governing this entity's statement layout. Change it via the change-reporting-style operation.
phone	String	—
website	String	—
status	String!	Operational status: 'active' \| 'inactive' \| 'dissolved'.
isParent	Boolean!	True for top-level entities; False for subsidiaries.
parentEntityId	String	Parent entity ID for subsidiaries; null for top-level.
source	String!	Provenance: 'native' \| 'sec' \| 'quickbooks' \| 'xero' \| 'plaid'.
sourceId	String	Source-system primary key for sync reconciliation.
sourceGraphId	String	Origin graph for received entities (cross-graph linking, e.g. RoboInvestor portfolio holdings).
connectionId	String	Source connection that ingested this row.
addressLine1	String	—
addressCity	String	—
addressState	String	—
addressPostalCode	String	—
addressCountry	String	—
createdAt	String	—
updatedAt	String	—

Example

query

{ entities { id name legalName uri } }

curl

curl -X POST "https://api.robosystems.ai/extensions/$GRAPH_ID/graphql" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ entities { id name legalName uri } }"}'