Traversal queries A1..G1 (TG-QRY-5 single binding)
POST/v4/graph/traverse
One endpoint, nineteen canonical queries (TG-QRY-3). Set query and give the matching input:
| query | returns | input (bold = required) |
|---|---|---|
| A1 | trust summary of a DID | did |
| A2 | governing chain: corporation + ecosystems | did |
| A3 | service endpoints | did |
| A4 | linked VPs and contained VTCs | did |
| A5 | credentials the DID holds | did, ecsSchema |
| A6 | credentials the DID issued | did, ecsSchema |
| A7 | participants of the DID by role | did, role |
| B1 | issuer recovery for a credential | did, credentialId |
| B2 | holder recovery for a credential | did, credentialId |
| C1 | schemas owned by an ecosystem | ecosystemId |
| C2 | participating DIDs grouped by role | ecosystemId, role, credentialSchemaId |
| C3 | ecosystem governance summary | ecosystemId |
| D1 | credentials based on a schema | credentialSchemaId |
| D2 | participating DIDs of a schema | credentialSchemaId, role |
| E1 | DIDs operated by a corporation | corporationId |
| E2 | ecosystems controlled by a corporation | corporationId |
| E3 | corporation governance summary | corporationId |
| F1 | path between two entities | from, to (EntityRef) |
| G1 | validator chain, root to leaf | participantId |
role: HOLDER, ISSUER, VERIFIER, ISSUER_GRANTOR, VERIFIER_GRANTOR, ECOSYSTEM. ecsSchema: ServiceCredential, OrganizationCredential, PersonaCredential, UserAgentCredential. EntityRef: {type, id} with type one of Did, Corporation, Ecosystem, CredentialSchema, Participant, EcsCredential, Vtc, LinkedVerifiablePresentation, ServiceEndpoint.
Collection queries take limit (1..500, default 100) and cursor. Non-ACTIVE participants appear in traversal with their true state while referenced (TG-ACT-1), search never returns them.
Errors (TG-ERR-1 envelope): INVALID_INPUT, UNKNOWN_QUERY, UNKNOWN_ID, UNKNOWN_FILTER_FIELD, INVALID_CURSOR.
Request
Responses
- 200
- 400
Query output with nextCursor
TG-ERR-1 error envelope