Developer Documentation

Introduction

The Figgro API provides 3rd-party developers and AI agents with read access to inventory and manufacturing data from the Figgro ERP platform. All endpoints are read-only (GET) and return paginated JSON responses.

Base URL

All endpoints are prefixed with /api/v1/. The base URL and versioning path will not change while on v1.

OpenAPI spec

The machine-readable spec is available at:

Quick start

curl -X GET \
  'https://developer.figgro.com/api/v1/Inventory/getproducts?page=1' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: fgr_your_key_here'

{
  "page": 1,
  "page_size": 25,
  "total_records": 142,
  "total_pages": 6,
  "data": [ /* array of product objects */ ]
}

Authentication

All requests must include a valid API key in the X-Api-Key request header. Requests without a key, or with an invalid key, return 401 Unauthorized.

X-Api-Key: fgr_your_key_here

Pagination

All list endpoints return paginated results using a consistent envelope. Use the page query parameter to navigate through results. Pages are 1-based.

Iterating all pages

async function getAllProducts() {
  const all = [];
  let page = 1, totalPages = 1;

  while (page <= totalPages) {
    const res = await fetch(
      `https://developer.figgro.com/api/v1/Inventory/getproducts?page=${page}`,
      { headers: { 'X-Api-Key': API_KEY } }
    ).then(r => r.json());

    all.push(...res.data);
    totalPages = res.total_pages;
    page++;
  }
  return all;
}

Endpoints

curl -X GET \
  'https://developer.figgro.com/api/v1/Inventory/getproducts?page=1' \
  -H 'X-Api-Key: fgr_your_key_here'

Errors

All errors return a consistent JSON body with a machine-readable code and a human-readable message.

{
  "code": "UNAUTHORIZED",
  "message": "Invalid or missing X-Api-Key header."
}

Rate limits

API keys are limited to 1,000 requests per hour per key. Limits are enforced on a rolling 60-minute window. Responses include rate-limit headers so you can pace your traffic.

Changelog