HTTP Responses

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"
}