---
title: "Get the issuer testing workspace"
method: GET
path: "/api/oid4vci/v1/testing/instances/{instanceId}/workspace"
tags: ["Testing"]
---

# Get the issuer testing workspace

`GET /api/oid4vci/v1/testing/instances/{instanceId}/workspace`

Returns operational dashboard aggregates, credential catalog metadata, and action URLs. AS-protected instances require their exact configured resource grant.

## Path parameters

- `instanceId` string, required

## Response `200`

Operational issuer testing workspace.

- IssuerTestingWorkspace
  - `service` 'oid4vci-issuer', required
  - `kind` 'issuer', required
  - `instanceId` string, required
  - `actions` IssuerTestingActions, required
    - `templates` string, uri, required
    - `direct` string, uri, required
    - `sessions` string, uri, required
    - `statusLists` string, uri, nullable
    - `dcql` string, uri, nullable
  - `dashboard` Oid4vciTestingDashboard, required
    - `credentialConfigurations` integer, required
    - `templates` integer, required
    - `sessions` TestingSessionAggregate, required
      - `total` integer, required
      - `recent` integer, required
      - `byState` object, required
      - `recentByState` object, required
      - `recentWindowSeconds` integer, required
  - `credentialConfigurations` Oid4vciTestingCredentialConfigurationSummary[], required
    - `id` string, required
    - `format` string, required
    - `scope` string, nullable
    - `display` Oid4vciTestingCredentialDisplay[], required
      - `name` string, required
      - `locale` string, nullable
      - `description` string, nullable
      - `logoUri` string, uri, nullable
      - `logoAltText` string, nullable
      - `backgroundColor` string, nullable
      - `backgroundImageUri` string, uri, nullable
      - `textColor` string, nullable
    - `statusListBound` boolean, required
    - `design` Oid4vciTestingCredentialDesignMetadata, required
      - `vct` string, nullable
      - `doctype` string, nullable
      - `credentialDefinitionTypes` string[], required
      - `credentialDefinitionContexts` string[], required
      - `claims` Oid4vciTestingCredentialClaim[], required
        - `path` string[], required
        - `mandatory` boolean, nullable
        - `valueType` string, nullable
        - `display` Oid4vciTestingCredentialDisplay[], required
          - `name` string, required
          - `locale` string, nullable
          - `description` string, nullable
          - `logoUri` string, uri, nullable
          - `logoAltText` string, nullable
          - `backgroundColor` string, nullable
          - `backgroundImageUri` string, uri, nullable
          - `textColor` string, nullable
      - `order` string[], required
    - `offerDefaults` Oid4vciTestingOfferDefaults, required
      - `preAuthorizedCodeGrant` boolean, required
      - `authorizationCodeGrant` boolean, required
      - `txCodeRequired` boolean, required
      - `offerTtlSeconds` integer, required
      - `scheme` string, required
      - `uriLifecycle` 'SINGLE_USE' | 'REUSABLE_FRESH_PER_FETCH', required

## Other responses

- `401` — The configured exposure mode requires the exact AS-issued resource grant.
- `404` — Testing surface is disabled or unavailable.

---

[API](https://skmtc.net/sphereon-opensource/apis/oid4vci-issuer-integration-api.md) · [All operations](https://skmtc.net/sphereon-opensource/apis/oid4vci-issuer-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sphereon-opensource/oid4vci-issuer-integration-api/versions/9672e59cf758/schema)