API Integration

Integrate delegation verification and management directly into your existing workflows.

Getting Started

Generate API keys from the Admin Console

Authenticate with X-Api-Key and X-Api-Secret headers

Start verifying and querying delegations in real time

M2M Authentication

Authenticate machine-to-machine requests using your organisation's API key and secret. Create and manage keys from the Admin Console. Each key tracks usage and can be revoked independently.

Verify a Delegation

Example Request

curl -X POST https://api.minion.se/api/v1/verify/MIN-K7P2-X9QR \
  -H "X-Api-Key: your_api_key" \
  -H "X-Api-Secret: your_secret"

Example Response

{
  "valid": true,
  "delegateName": "Anna Svensson",
  "grantorName": "Erik Lindqvist",
  "organisation": "Nordea AB",
  "operations": ["Contract Signing"],
  "validFrom": "2026-01-01T00:00:00Z",
  "validTo": "2026-12-31T23:59:59Z",
  "verificationCode": "MIN-K7P2-X9QR",
  "isGrantorSigned": true,
  "isDelegateSigned": true
}

External Delegations API

Query all delegations associated with your organisation. Supports pagination, status filtering and lookup by verification code.

Example Request

curl -X GET "https://api.minion.se/api/v1/external-delegations?page=1&limit=20" \
  -H "X-Api-Key: your_api_key" \
  -H "X-Api-Secret: your_secret"

Example Response

{
  "items": [
    {
      "id": "d1a2b3c4",
      "verificationCode": "MIN-K7P2-X9QR",
      "delegateName": "Anna Svensson",
      "grantorName": "Erik Lindqvist",
      "status": "Active",
      "validFrom": "2026-01-01",
      "validTo": "2026-12-31"
    }
  ],
  "page": 1,
  "limit": 20,
  "totalCount": 1
}

Corporate API

Endpoints for corporate onboarding, document upload and application status tracking. Full programmatic access to the corporate workflow.

Ready to integrate?

Get Started