Read sandbox organisation
GET/v2/config/sandbox-org/:sandboxOrgId
Reads one sandbox organisation of the organisation. Give the sandbox organisation ID in the path.
The response also gives the OpenID endpoints of the wallet of the sandbox organisation. Use these endpoints to point a holder wallet or an external IT system to this sandbox organisation. If the sandbox organisation has no OpenID deployment, all the endpoint fields hold an empty string.
Request
Path Parameters
Unique identifier of the sandbox organisation.
Responses
- 200
- 401
- 404
- 500
The service returns the sandbox organisation.
Response Headers
- application/json
- Schema
- Example (from schema)
- Example
Schema
sandboxOrg object
Unique identifier of the sandbox organisation
Display name of the sandbox organisation
Human readable description of the sandbox organisation
Identifier of the associated OpenID deployment
Status code of the sandbox organisation
Identifier of the associated ledger
Name of the infrastructure provider
Version of the sandbox organisation configuration
Role of the sandbox organisation in the ecosystem
Trust anchor identifier or DID
Indicates whether this sandbox organisation acts as a wallet provider
Identifier of the primary secure vault
Identifiers of the secure vaults that the sandbox organisation uses. The field holds null when the sandbox organisation has no secure vault.
Identifier of the logo image. The field is absent when the sandbox organisation has no logo image.
Identifier of the cover image. The field is absent when the sandbox organisation has no cover image.
Public URL for the logo image
Public URL for the cover image
Timestamp when the sandbox organisation was created
Timestamp when the sandbox organisation was last updated
Indicates whether this is the main organisation
Base URL of the wallet of the sandbox organisation.
URL of the credential issuer metadata of the sandbox organisation. A wallet reads this document to start an OID4VCI flow.
URL of the authorization server metadata of the sandbox organisation. A wallet reads this document to find the token endpoint and the supported grant types.
URL of the OID4VCI notification endpoint of the sandbox organisation. A wallet sends the result of a credential issuance to this endpoint.
URL of the JSON Web Key Set of the sandbox organisation. A wallet reads the public keys from this endpoint to validate the signature of a credential.
{
"sandboxOrg": {
"id": "string",
"name": "string",
"description": "string",
"openIdDeploymentId": "string",
"status": 0,
"ledgerId": 0,
"infrastructureProvider": "string",
"version": "string",
"role": "string",
"trustAnchor": "string",
"isWalletProvider": true,
"secureVault": 0,
"secureVaults": [
0
],
"logoImageId": "string",
"coverImageId": "string",
"logoImageUrl": "string",
"coverImageUrl": "string",
"createdAt": 0,
"updatedAt": 0,
"isMain": true,
"agentServiceEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service",
"credentialIssuerMetadata": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/.well-known/openid-credential-issuer",
"authorizationServerMetadata": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/.well-known/oauth-authorization-server",
"notificationEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/notification",
"jwksEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/jwks"
}
}
{
"sandboxOrg": {
"id": "6889e1a4c5b2f30001a3d710",
"name": "Acme Test Issuer",
"description": "Sandbox organisation for issuance tests",
"openIdDeploymentId": "6889e1a4c5b2f30001a3d711",
"status": 2,
"ledgerId": 0,
"infrastructureProvider": "iGrant",
"version": "1.0.0",
"role": "",
"trustAnchor": "",
"isWalletProvider": false,
"secureVault": 0,
"secureVaults": null,
"logoImageId": "6889e1a4c5b2f30001a3d6f0",
"coverImageId": "6889e1a4c5b2f30001a3d6f1",
"logoImageUrl": "https://demo-api.igrant.io/v2/onboard/image/6889e1a4c5b2f30001a3d6f0/web",
"coverImageUrl": "https://demo-api.igrant.io/v2/onboard/image/6889e1a4c5b2f30001a3d6f1/web",
"createdAt": 1754745764,
"updatedAt": 1754745764,
"isMain": false,
"agentServiceEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service",
"credentialIssuerMetadata": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/.well-known/openid-credential-issuer",
"authorizationServerMetadata": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/.well-known/oauth-authorization-server",
"notificationEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/notification",
"jwksEndpoint": "https://demo-api.igrant.io/v3/organisation/6889e1a4c5b2f30001a3d711/service/jwks"
}
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}
The organisation has no sandbox organisation with this ID.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}
Internal server error
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}