List sandbox organisations
GET/v2/config/sandbox-orgs
Lists the sandbox organisations of the organisation. The service sorts the list by the time of the last update, and it does not list deleted sandbox organisations.
Use the offset and the limit query parameters to page through the list. Use the search query parameter to filter the list, and the sortOrder query parameter to change the sort direction.
The response gives the sandbox organisation records only. To get the OpenID endpoints of one sandbox organisation, read it with GET /config/sandbox-org/{sandboxOrgId}.
Request
Query Parameters
Default value: 0
Number of records to skip for pagination. A negative or unreadable value falls back to 0.
Default value: 10
Maximum number of records to return per page.
Search term to filter results by
Possible values: [desc, asc]
Default value: desc
Sort order for the returned records (ascending or descending).
Responses
- 200
- 401
- 500
The service returns the sandbox organisations and the pagination data.
Response Headers
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
sandboxOrgs object[]required
The sandbox organisations on the current page.
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
pagination objectrequired
Current page number
Total number of items available
Total number of pages based on limit
Number of items per page
Indicates if there's a previous page
Indicates if there's a next page
{
"sandboxOrgs": [
{
"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
}
],
"pagination": {
"currentPage": 1,
"totalItems": 25,
"totalPages": 3,
"limit": 10,
"hasPrevious": false,
"hasNext": true
}
}
{
"sandboxOrgs": [
{
"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
}
],
"pagination": {
"currentPage": 1,
"totalItems": 1,
"totalPages": 1,
"limit": 10,
"hasPrevious": false,
"hasNext": false
}
}
Unauthorized
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"
}