List Service Resources

Use resource-api/resources/list to inspect which child resources exist beneath a specific target—this can be a tenant (to see all services) or a service (to see internal resources such as keys, issuance sessions, etc.). Think of it as traversing the organization tree one level at a time. The API returns the full objects for each child, so the shape of each entry depends on the resource type.

List child resources

CURL

Endpoint: /v1/{target}/resource-api/resources/list | API Reference

Example Request

curl -X 'GET' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/resource-api/resources/list' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {yourToken}'

Path Parameters

  • orgID: Use the organization’s base URL / host alias (e.g., test.enterprise-sandbox.waltid.dev in sandbox).
  • target: resourceIdentifier – The node whose immediate children you want to inspect. Examples:
    • Tenant: test.sandbox → returns all services under that tenant.
    • Service: test.sandbox.kms-eu → returns resources stored under that service (e.g., test.sandbox.kms-eu.key1).

Example Response 200 OK

Listing the children of a KMS service returns the stored keys:

[
  {
    "type": "key",
    "_id": "test.sandbox.kms-eu.key1",
    "key": {
      "type": "jwk",
      "jwk": {
        "kty": "OKP",
        "d": "rvg7ubJTALaDY-tTEj-67swXNJGQ_GqOkiwGOnfVtxw",
        "crv": "Ed25519",
        "kid": "lLOWUTsTh7Dyy39eBTtNgBe5iZ6FHE0gUpQ85xNDc-s",
        "x": "o3wj5Lhpi8im7BzujhKVvW_WOCMF3u5zAmg5FTjezGM"
      }
    },
    "parent": "test.sandbox.kms-eu"
  }
]

Treat this endpoint as a generic “show me the next level down” helper and then pass the returned objects (or their _ids) into /metadata, /configuration, or service-specific APIs for further actions.

Last updated on December 3, 2025
Create ServiceDelete Service