MineTech API

MineTech is the intelligence layer for mining operations. This API exposes the same data and actions the MineTech portal uses: production and traceability, workforce and payroll, safety and incidents, compliance, inventory, environmental monitoring, finance and reporting.

Shape of the API

REST over HTTPS, JSON in and out. One flat namespace:

https://api.minetech.rw/v1/<resource>

You never need to know which internal service owns a resource — /v1/operations/lots and /v1/disbursements are addressed identically.

Start here

Quickstart

First authenticated call and first webhook, in about five minutes.

Authentication

Keys, request signing, IP allowlists, and every auth error explained.

Webhooks

Receive changes as they happen instead of polling.

API reference

Every endpoint, generated from the live specification.

Conventions

• Environments — mt_test_… keys reach an isolated sandbox; mt_live_… reach production. Details.
• Errors — one contract across every endpoint. Details.
• Pagination — page and limit, with a meta block. Details.
• Idempotency — send Idempotency-Key on writes so retries are safe. Details.
• Rate limits — per key, per minute, with Retry-After on 429. Details.

A note on response schemas

The reference is generated from the API's own OpenAPI specification. Many endpoints do not yet publish a response schema, and those operations are marked "schema not yet documented" rather than being given an invented one. Request parameters and bodies are fully documented throughout.

We would rather show you an honest gap than a plausible fiction. Progress is tracked on the schema coverage page and improves with each release — no change needed on your side.

SDKs

The Node.js SDK is available now. Python, PHP and Go are planned.

npm install @minetech/node

Support

engineering@minetech.rw. Include the x-request-id from the response — it identifies your exact request in our logs.