Skip to content

This guide demonstrates making your first authenticated request to the Zimark API.

Prerequisites

Before you begin, ensure you have:

  • ✅ Access to a Zimark environment
  • ✅ REST base URL: https://api.zimark.link/
  • ✅ An API key (create one)

Make Your First Request

Test your API key by fetching users from your organization.

Test in Browser

Use the interactive API documentation:

  1. Open Get Users

  2. Click Try it Try it

  3. Select your environment Select environment

  4. Add your API key to the X-AUTH-KEY header Select environment

  5. Click Send

Request examples

curl -X GET "https://api.zimark.link/integration/rest/api/v1/user?pageSize=5" \
  -H "X-AUTH-KEY: ZIM.your-api-key-here" \
  -H "Content-Type: application/json"

Response

{
  "content": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "authority": {
        "authorityName": "Organization Admin"
      }
    }
  ],
  "totalElements": 1
}