Overview

The MakersHub API allows you to programmatically manage invoices and sync external data. This API follows REST conventions and returns JSON responses.

Base URL

All API requests should be made to: https://makershub.ai/server/external/api/

Authentication

All endpoints require Bearer token authentication. Include your API token in the Authorization header: Authorization: Bearer your_api_token_here

Return Status Codes

Code	Status	Description
200	OK	Request successful.
400	Bad Request	Invalid request. Check for missing required fields or malformed data.
401	Unauthorized	Authentication failed. Verify your API token.
403	Forbidden	Access denied. Your token may lack required permissions.
404	Not Found	The requested resource does not exist.
415	Unsupported Media Type	Invalid Content-Type header. Must be `application/json`.

Data Formats

Field Type	Format	Example
Invoice ID	Integer	`12345`
Date	YYYY-MM-DD	`2024-01-15`
Timestamp	ISO 8601	`2024-01-15T10:30:00Z`
File Data	Base64 encoded	`JVBERi0xLjQK...`
Tags	Comma-separated	`verified,q1-2024`

Glossary

Term	Definition
API Token	A unique authentication credential used to identify and authorize API requests.
AP Account	Accounts Payable account used for recording vendor liabilities.
Approver	A user who has performed an action (approve/reject) on an invoice.
Base64	A binary-to-text encoding scheme used to transmit file data.
Batch Import	Sending multiple records (up to 100) in a single request.
Bearer Token	Authentication method with token in the `Authorization` header.
Class ID	Reference to an accounting class for categorization.
Grouped Invoice	Multiple invoices combined under a single parent.
Item Receipt	Record documenting goods received from a Purchase Order.
Line Item	Individual product or service entry within a document.
OCR	Optical Character Recognition - technology that extracts text from images and PDFs.
Partial Success	Some records saved successfully while others fail validation.
Purchase Order	Commercial document indicating types, quantities, and prices.
Supplier ID	Unique identifier for a vendor in your system.

Contact
MakersHub Support support@makershub.ai