InventoryPro

Contents

api

Quickstart

Quickstart

This guide walks you through authenticating with the API and making your first requests. You’ll get a token, list items, and create a new item — all from the command line.

Prerequisites

You need: API credentials (client ID and secret), your base URL, and curl or PowerShell.

Step 1: Get a Token

curl -X POST https://your-host/api/v1/Token \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"
{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1Ni...",
  "token_type": "bearer",
  "expires_in": 14399
}

Save the access_token — include it in every subsequent request. PowerShell users: see Authentication for an Invoke-RestMethod equivalent.

Step 2: List Items

curl "https://your-host/api/v1/Item?page=1&pageSize=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "value": [
    {
      "partNo": 1,
      "shortID": "BOLT-M8",
      "description": "Hex Bolt M8x30",
      "categoryID": 5,
      "unit": "EA"
    }
  ],
  "totalCount": 2340,
  "page": 1,
  "pageSize": 5,
  "pageCount": 468,
  "hasMore": true
}

Step 3: Get a Single Item

curl https://your-host/api/v1/Item/1 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

The response is the full item object — no paging wrapper.

Step 4: Create an Item

curl -X POST https://your-host/api/v1/Item \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "shortID": "TEST-API-001",
    "description": "Created via API",
    "unit": "EA",
    "categoryID": 1
  }'
{
  "partNo": 2341,
  "shortID": "TEST-API-001",
  "description": "Created via API",
  "unit": "EA",
  "categoryID": 1,
  "active": true
}

A 201 Created response includes the full item with its assigned partNo.

Note: A 403 response means your credentials lack write access to the item master.

What’s Next

On this page