API Key
An API key is required for all PlanOmatic API requests and can be found in your integration's details page in PlanOintegrate. If you don't have access to PlanOintegrate, email [email protected] to request access.
When testing, please note that your production API key will be different from your QA API key.
Test Environment (QA)
PlanOmatic's QA environment is a production-like copy of our platform for testing your API usage. Access is granted on request through [email protected]; there is no self-serve sandbox. Learn more
Production and QA URL Examples
# Production API
https://api.planomatic.com/api/v3/orders/create
# QA API
https://api.qa.planomatic.com/api/v3/orders/createRate Limiting
PlanOmatic's APIs are rate limited per API key to 100 API requests every 60 seconds. If your system goes over our rate limit, you will receive a 429 response back from our APIs. If you have a queueing system, we recommend limiting requests to one request every two seconds.
Error Handling
API endpoint responses will always return a code attribute. The code attribute signifies whether your HTTP request was successful or rejected. A successful HTTP request will yield 200 for a successful GET request and 201 for a successful POST/PUT request. Alternately, the endpoint will return status 400 for all rejected HTTP requests. Check out validation errors >.
HTTP Headers
In your HTTP headers, the content-type application/json is expected for all API requests. The Order API currently only supports JSON POST requests.