Request Types, Permissions, Errors, & Limits

CREATING REQUESTS

According to RESTful structure, Acquire implements the following HTTP verbs: GET - Read entity POST - Create new entity PUT - Modify existing entity DELETE - Remove entity

PERMISSIONS

To request any API endpoint, you will need a valid API key with the related access permissions.
Learn more about obtaining an API key and access permissions in the Authorization section.

Errors

Errors are returned using standard HTTP error codes.
In general, the list of error codes includes:
Code
Explanation
2xx
Success
4xx
Bad request sent to the server
5xx
Server-side error

STATUS CODES

200 OK Successful request. 400 Bad Request Returns JSON with the error message. 401 Unauthorized Couldn’t authenticate your request. 403 Forbidden Invalid request. 404 Not Found No such object. 500 Internal Server Error Something went wrong. 503 Service Unavailable Service is down for maintenance.
Types
Code
Explanation
ERROR_INVALID_INPUT
400
Invalid request
ERROR_RECORD_NOT_FOUND
400
No credentials in the request body
ERROR_DUPLICATE_RECORD_FOUND
400
Already exists
ERROR_UNAUTHORIZED
401
Missing, incorrect, or invalid API Key
ERROR_UNAUTHORIZED_ACCESS
403
Invalid request
ERROR_SERVER_ERROR
500
Internal server error

API Limit

There are no API consumption limits.
Last modified 4mo ago