Delegate

List delegates

A delegate is a person, authenticated by BankID and associated with a unique PSU. Read more about the concepts Tenant, PSU and delegate in the Developer resources

get/psu/{psuId}/delegate

Request

  • Base URL: https://bankapidemo.svea.com
  • URL: https://bankapidemo.svea.com/psu/{psuId}/delegate
  • Auth: Bearer (a scheme the document does not define)

Path parameters

psuIdstring uuid required
Example:febbe8f2-bd6b-4e53-89c6-e89ca92ff5ee

Headers

Authorizationstring required
Example:Bearer {BearerToken}
X-Svea-ClientAppstring required

Tenant client app name, version, and optional comment <client-app-name>/<version>(/<comment>)

Example:TENANT-IOS/0.99.0
X-Svea-CorrelationIdstring uuid

The correlationId is a unique identifier value that is attached to requests and messages that allow reference to a particular transaction or event chain. Used to follow transaction information, especially for logging purposes.

Example:21436a05-d62d-4f29-a253-31b3815d148b
X-Svea-SessionIdstring uuid

The sessionId is a unique identifier value for a users session. This identifier should be the same for the entire duration of that users session. Mainly used for logging and troubleshooting purposes.

Example:afe56332-dee2-48b4-ae0b-d694a6174a7e

Response

OK

accessLevel'restrictedLevel' | 'fullAccessLevel' | 'approveLevel' | 'prepareLevel' | 'cardHolderLevel' required

Note! New accessLevels are created upon request by the tenant and must be supported in the clients before delivery to production.

correspondenceNamestring required
delegateIdstring uuid required
emailstring nullable required
personKeystring required

Example response

[
  {
    "accessLevel": "restrictedLevel",
    "accessLevelContext": [
      {
        "accountAccessLevel": "read",
        "bankAccountId": "ccf7c77a-8e32-4d9b-8f40-ea446f37d492"
      }
    ],
    "correspondenceName": "Anna Andersson",
    "delegateId": "4a1fd043-a5ad-4bf1-894c-007fed391c63",
    "personKey": "194604296485",
    "phoneNumber": {
      "countryCode": "+46",
      "domesticNumber": "0701234567"
    }
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.