Skip to main content

Central API Examples

In the examples below use the following placeholder variables to match commonly-needed parameters:

  • $ZT_TOKEN: an API token associated with an active account on Central
  • $NWID: an active network ID
info

See the Central API Tokens guide for an explanation of how to create and manage API tokens.

Exporting Data from the Central API​

The examples below are intended to run in a system terminal, and require the following command-line tools:

Each of them will fetch network information and produce CSV as output. You can then import that CSV into your choice of database, spreadsheet, or configuration-management tool(s).

List current networks​

curl -s -H "Authorization: token $ZT_TOKEN" \
  "https://api.zerotier.com/api/v1/network" \
  | jq '.[] | [
    .id,
    .config.name,
    .config.description,
    .totalMemberCount,
    .config.creationTime,
    .config.ipAssignmentPools[0].ipRangeStart,
    .config.ipAssignmentPools[0].ipRangeEnd
  ]' \
  | jq -rs '.[] | @csv'

Authorize and Deauthorize Network Members​

Authorize a network member​

curl -H "Authorization: token $ZT_TOKEN" -X POST \
  "https://api.zerotier.com/api/v1/network/$NWID/member/$MEMBER_ID" \
  --data '{"config": {"authorized": true}}'