API Access (Beta)
Last updated
Last updated
The PoI API allows developers to programmatically generate cryptographic proofs for their invention files. This API is currently in beta and requires an API key for access.
Important: This API is currently in beta. To request API access, please join our and reach out to our team to obtain an API key.
All API requests require authentication using an API key. Use the Bearer token authentication method:
Creates a merkle tree from uploaded files and returns the merkle root along with transaction data.
Endpoint: POST /api/v1/inventions
Content-Type: multipart/form-data
Request Parameters:
files
File[]
Yes
Array of files to include in the proof of invention
Example Request:
Success Response:
The API returns appropriate HTTP status codes along with error messages in the response body:
400
Bad Request - Invalid input parameters
401
Unauthorized - Invalid or missing API token
415
Unsupported Media Type - Invalid Content-Type header
500
Internal Server Error - Something went wrong on the server
After receiving a successful response from the API, you'll need to submit the transaction to the blockchain to store your proof on-chain:
Use the transaction
object from the API response
Submit a transaction to any supported EVM blockchain (listed in supportedEvmChainIds
)
Use the payload
as transaction data and recipient
as the recipient address
This transaction creates a permanent, timestamped record of your proof of invention on the blockchain.
Maximum file size: 100MB (total for all files)
Supported file types: All file types are supported
API Rate Limits: During the beta period, the API is limited to 100 requests per day per API key.
File Storage: Files are processed to create the merkle tree but are not stored on our servers.
Transaction Handling: The API returns the transaction data, but you are responsible for submitting the transaction to the blockchain.
As part of our beta program, we're actively seeking feedback to improve the API. If you have suggestions or feature requests, please share them with us on Discord.
Last updated: May 22, 2025
If you encounter any issues or have questions about the API, please join our for support.