Holders

A holder is something or someone who holds one or more identities.

Get all holders

You can retrieve all holders.

GET /holder/ HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]
[
    {
        "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
    },
    {
        "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
    }
]

Get one holder

You can retrieve a single holder.

GET /holder/[HOLDER_URI] HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]
{
    "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
}

Create one holder

You can create a single holder.

POST /holder/ HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]

{
    "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
}
{
    "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
}

Merge holders

You can merge multiple holders into one.

POST /holder/[HOLDER_URI]/merge HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]

["https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-5555"]
{
    "uri": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456"
}