Bulk Admins Download API (Early Access)

POST

https://app.balkan.id/api/rest/v0/admins/download-url

BalkanID Admins Download CSV Format

In this section, we will explain the BalkanID Admins CSV format.

Sample CSV

Email	Is Employee
mark@example.com	true
james@example.com	false

Column Definitions

Column Name	Column Definition
Email	Email of the employee
Is Employee	Whether the admin is an employee or not in the tenant

Download the CSV file via the pre-signed URL

After retrieving the pre-signed URL in the previous step, all that remains
is to download the CSV in BalkanID Admins CSV
format from the pre-signed URL.

To use the polling URL, first send an HTTP request with the method HEAD to
the pollingUrl.

If the response status code is 404, the file is not ready, and you should
retry this polling request after a delay.

If the response status code is 200, the file is ready, and you may proceed
to download the CSV from the received url.

Request

Header Params

Body Params application/json

Example

{
    "onlyNonEmployeeAdmins": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.balkan.id/api/rest/v0/admins/download-url' \
--header 'X-Api-Key-ID;' \
--header 'X-Api-Key-Secret;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "onlyNonEmployeeAdmins": true
}'

Responses

🟢200OK

application/json

download url response

Body

Example

{
    "pollingUrl": "string",
    "url": "string"
}

🔴500Server Error

Modified at 2025-04-10 03:44:22

Introduction

Bulk Apps Download API (Early Access)

Bulk Admins Download API (Early Access)

BalkanID Admins Download CSV Format#

Sample CSV#

Column Definitions#