Skip to main content

User details

Read the users connected to you. You get the user's safepayAccountId from the Connect flow.

List users​

List users
curl https://sandbox-api.safepaynordic.dk/v2/users \
  -H 'Authorization: Bearer {API_TOKEN}'
Response example
{
    "items": [
        {
            "safepayAccountId": "9a1d4a0c-9700-4e18-bc77-7bc7d4a32c66",
            "name": "John Doe",
            "phoneNumber": "+45 12345678",
            "phoneNumberVerified": true,
            "created": "2026-01-01T11:00:00Z",
            "type": "Private"
        }
    ]
}

Users are returned newest first. The endpoint accepts these optional query parameters:

  • skip / take: Page through the results. take defaults to 20 and is capped at 100.
  • public: By default, the list contains the users connected to you and the public business accounts that Safepay Nordic makes available to all marketplaces. Use public=false to get only the users connected to you, or public=true to get only the public accounts.

Get user​

Get user details
curl https://sandbox-api.safepaynordic.dk/v2/users/{safepayAccountId} \
  -H 'Authorization: Bearer {API_TOKEN}'
Response example
{
    "safepayAccountId": "9a1d4a0c-9700-4e18-bc77-7bc7d4a32c66",
    "connections": [
        {
            "referenceId": "your-user-id",
            "connected": "2026-01-01T11:00:00Z"
        }
    ],
    "name": "John Doe",
    "type": "Private",
    "kyc": {
        "level": "Medium"
    },
    "email": "john.doe@example.com",
    "phoneNumber": "+45 12345678",
    "phoneNumberVerified": true,
    "dateOfBirth": null,
    "cpr": null,
    "cvr": null,
    "address": null
}

The endpoint returns 404 Not Found if the user doesn't exist or isn't connected to you.

Fields​

  • connections: Your referenceIds for this user, newest first.
  • type: Private, Business or Guest.
  • kyc.level: Low, Medium or High.
  • cvr: The company registration number. Only set for Business users.
  • dateOfBirth / cpr / address: Only returned if extended user data is enabled for your account. Contact Safepay Nordic to have it enabled; otherwise these fields are null.