light-mode-image
Learn
MATTR VII PlatformParticipants

Create participant

Creates a participant in the requested ecosystem.

Analytics Events

ECOSYSTEM_PARTICIPANT_CREATE_STARTECOSYSTEM_PARTICIPANT_CREATE_SUCCESSECOSYSTEM_PARTICIPANT_CREATE_FAIL

Roles

admindts-provider
POST/v1/ecosystems/{ecosystemId}/participants
AuthorizationBearer <token>

In: header

Path Parameters

namestring

Name to easily identify the participant.

Length1 <= length <= 50
identifiersobject

Define the unique identifier that will be used by this participant to issue and/or verify credentials. Participants can have different identifiers for different credential formats. Each participant must have at least one defined credential format, and for each credential format a participant can define exactly one unique identifier.

  • Credentials are only valid in the ecosystem if they include an identifier of an issuer that is a participant in the ecosystem.
  • Verification requests are only valid in the ecosystem if they include an identifier of a verifier that is a participant in the ecosystem.
  • For mDocs this must be the PEM of a valid IACA used by this participant to sign mDocs, as defined in annex B of ISO/IEC 18013-5:2021. An exception to this aforementioned definition is that IACAs with a notBefore date in the future are considered valid.
isIssuer?boolean

Indicates whether the participant is an issuer in the ecosystem (true) or not (false). When set to false, the participant will not be able to issue any valid credential types, even if it is added to an issuer policy. The default value is false, as this assigns the least privileges to the new participant.

Defaultfalse
isVerifier?boolean

Indicates whether the created participant is a verifier in the ecosystem (true) or not (false). When set to false, the participant will not be able to verify any valid credential types, even if it is added to a verifier policy. The default value is false, as this assigns the least privileges to the new participant.

Defaultfalse
isIssuerConstrained?boolean

Indicates whether the created participant is constrained to only issue specific types of valid credentials (true) or not (false). When set to false, the issuer can issue all valid credential types defined within the ecosystem, even if it is added to a more limited issuer policy. The default value is true, as this assigns the least privileges to the new participant.

Defaulttrue
isVerifierConstrained?boolean

Indicates whether the created participant is constrained to only verify specific types of valid credentials (true) or not (false). When set to false, the verifier can verify all valid credential types defined within the ecosystem, even if it is added to a more limited verifier policy. The default value is true, as this assigns the least privileges to the new participant.

Defaulttrue
status?string

Indicates whether the participant is active or inactive. Only active participants are included in the ecosystem policy.

Default"Inactive"
Value in"Active" | "Inactive"
country?string

The country in which the participant is based. When provided, must be a valid Alpha 2 country code as per ISO 3166-1 and match the country value in the PEM certificate associated with the mobile identifier of this participant.

stateOrProvince?string

The state or province in which the participant is based, in ISO 3166-2 subdivision code format. When provided, must match the stateOrProvinceName value in the PEM certificate associated with the mobile identifier of this participant.

organizationAddress?string

The address of the organization that the participant represents.

organizationPhoneNumber?string

The phone number of the organization that the participant represents.

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v1/ecosystems/87880d7e-a4d0-462e-8383-3f1e5e16865d/participants" \  -H "Content-Type: application/json" \  -d '{    "name": "My Participant",    "identifiers": {}  }'
{
  "id": "a24e391a-c27f-4b6e-9805-1ee7e03f3c58",
  "ecosystemId": "87880d7e-a4d0-462e-8383-3f1e5e16865d",
  "name": "My Participant",
  "identifiers": {
    "web-semantic": "did:web:example.com",
    "compact-semantic": "did:web:example.com",
    "compact": "did:web:example.com",
    "mobile": [
      {
        "certificatePem": "-----BEGIN CERTIFICATE-----\r\nMIIBwzCCAWigAwIBAgIKRGC+CqoTGJKkkTAKBggqhkjOPQQDAjAgMR4wCQYDVQQG\r\nEwJOWjARBgNVBAMTCk1BVFRSIElBQ0EwHhcNMjMwODA4MDAwOTIxWhcNMzMwODA1\r\nMDAwOTIxWjAgMR4wCQYDVQQGEwJOWjARBgNVBAMTCk1BVFRSIElBQ0EwWTATBgcq\r\nhkjOPQIBBggqhkjOPQMBBwNCAASRu69fzdgM4odkyPtRcZd3eGWCw4BB7StZNGRm\r\nuIlrraUyv9SWPHgUYjYmRB1g7ERzj/pOSAspk71Y+QA+j9nPo4GJMIGGMBIGA1Ud\r\nEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgAGMB0GA1UdDgQWBBSONcHGh4If\r\nO1dYorRpsuFrs+f8SDAcBgNVHRIEFTATgRFpbmZvQG1hdHRyLmdsb2JhbDAjBgNV\r\nHR8EHDAaMBiiFoYUaHR0cHM6Ly9tYXR0ci5nbG9iYWwwCgYIKoZIzj0EAwIDSQAw\r\nRgIhAPKJIGDSvp7VxRBLCWWeghqi8UUeO+dZsC49TUZcDMNxAiEAoh+7dT+l+GzX\r\nk0J2SoGmPiagrbAuIYyTHwzZZuYr1W4=\r\n-----END CERTIFICATE-----\r\n",
        "status": "Active",
        "docTypes": [
          "org.iso.18013.5.1"
        ]
      }
    ]
  },
  "isIssuer": false,
  "isVerifier": false,
  "isIssuerConstrained": true,
  "isVerifierConstrained": true,
  "status": "Active",
  "country": "US",
  "stateOrProvince": "US-AL",
  "organizationAddress": "1234 Main St, City, State, 12345",
  "organizationPhoneNumber": "012-3456789"
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
Empty

How would you rate this page?