---
title: "List Service Resources"
description: "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.).…"
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/administration/services/list-resources
generated: 2026-07-20
---
# 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

**Option: CURL**

Endpoint: `/v1/{target}/resource-api/resources/list` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%7C%20Resource/get_v1__target__resource_api_resources_list)

**Example Request**

```bash
curl -X 'GET' \
  'https://{orgHost}.enterprise-sandbox.waltid.dev/v1/{target}/resource-api/resources/list?limit=50&offset=0' \
  -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`).

**Query Parameters**

- `limit`: _Integer (optional)_ – Maximum number of entries to return. Defaults to `100`.
- `offset`: _Integer (optional)_ – Number of entries to skip. Defaults to `0`.

Invalid values (`limit <= 0`, `limit` above the configured maximum, `offset < 0`, or non-integer values) return `400 Bad Request`. See the [pagination reference](https://docs.walt.id/enterprise-stack/setup/configurations/config-files/pagination.md) for the full contract.

---

**Example Response** `200 OK`

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

```json
[
  {
    "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 `_id`s) into `/metadata`, `/configuration`, or service-specific APIs for further actions.