Overview
Whenever you send a request to the Acquired.com API you will receive a response in JSON format and a HTTP status code. The status code indicates the success or failure of a request to the server.
HTTP responses
Here is the list of HTTP responses that we use at Acquired.com:
Code | Name | Description |
---|---|---|
200 | OK | Standard response for successful HTTP requests. Indicates that everything worked as expected. |
201 | Created | The request has been fulfilled, resulting in the creation of one or more new resources. |
400 | Bad Request | The Acquired.com API was unable to understand your request. This could be due to a syntax error. |
401 | Unauthorized | Authentication to the Acquired.com API failed resulting in an error response. This could be because you incorrectly entered your API keys or failed to enter them. |
403 | Forbidden | You do not have the required access to the requested resource. |
409 | Conflict | The request conflicts with another request. |
500 | Internal Server Error | An internal server error occurred while processing your request. |
Successful request response
When your request is successful, you will receive either a 200 - OK
or 201 - Created
response.
200 - OK
In the below request we are updating a customer record:
{
"last_name": "Jones"
}
Response:
{
"status": "Success"
}
201 - Created
In this request we are creating a new card:
{
"holder_name": "E Johnson",
"scheme": "visa",
"number": "4242424242424242",
"expiry_month": 12,
"expiry_year": 26,
"cvv": "123"
}
Response:
{
"card_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}