API response codes

reading time 3 minutes

<div class="ink-cat-header">
  Inkit uses a RESTful API approach and utilizes appropriate HTTP response codes to indicate the status of API requests (success or failure).
</div>
<div class="ink-hr"></div>

> 📘 According to RESTful HTTP standards
>
> - 2xx error codes indicates success;
> - 4xx error codes indicates input error (incorrect data/wrong credentials or permissions denied);
> - 5xx error codes indicates an error on Inkit's side.

<div class="ink-hr"></div>

You can find the described status code (code number, code name and the meaning).

<HTMLBlock>{`
<div class="ink-statuses-wrapper">
   <div class="ink-status-item">
     <div class="ink-status-code success">200</div>
      <div class="ink-status-label success">
       SUCCESS
     </div>
     <div class="ink-status-meaning">Successful API request.</div>
   </div>
  
   
   <div class="ink-status-item">
     <div class="ink-status-code success">201</div>
      <div class="ink-status-label success">
       CREATED
     </div>
     <div class="ink-status-meaning">Successfully created resource.</div>
   </div>
  
    <div class="ink-status-item">
     <div class="ink-status-code success">202</div>
      <div class="ink-status-label success">
       ACCEPTED
     </div>
     <div class="ink-status-meaning">Successfully processed request. Request may or may not still fail.</div>
   </div>
 
   <div class="ink-status-item">
     <div class="ink-status-code failure">400</div>
      <div class="ink-status-label failure">
       BAD REQUEST
     </div>
     <div class="ink-status-meaning">Your request is invalid.</div>
   </div>
  
     <div class="ink-status-item">
     <div class="ink-status-code failure">401</div>
      <div class="ink-status-label failure">
       UNAUTHORIZED
     </div>
     <div class="ink-status-meaning">Authorization error with your API key or account.</div>
   </div>
  
       <div class="ink-status-item">
     <div class="ink-status-code failure">403</div>
      <div class="ink-status-label failure">
       FORBIDDEN
     </div>
     <div class="ink-status-meaning">Forbidden error with your API key or account.</div>
   </div>
  
         <div class="ink-status-item">
     <div class="ink-status-code failure">404</div>
      <div class="ink-status-label failure">
       NOT FOUND
     </div>
     <div class="ink-status-meaning">The specified resource could not be found.</div>
   </div>
  
   <div class="ink-status-item">
     <div class="ink-status-code failure">405</div>
      <div class="ink-status-label failure">
       NOT ALLOWED
     </div>
     <div class="ink-status-meaning">HTTP Method not allowed for the endpoint.</div>
   </div>
  
  
     <div class="ink-status-item">
     <div class="ink-status-code failure">422</div>
      <div class="ink-status-label failure">
       BAD REQUEST
     </div>
     <div class="ink-status-meaning">The query or body parameters did not pass validation.
     </div>
   </div>
  
       <div class="ink-status-item">
     <div class="ink-status-code failure">500</div>
      <div class="ink-status-label failure">
       INTERNAL SERVER ERROR
     </div>
     <div class="ink-status-meaning">An internal server error occurred, please contact [email protected].
     </div>
   </div>
  
         <div class="ink-status-item">
     <div class="ink-status-code failure">503</div>
      <div class="ink-status-label failure">
       SERVICE UNAVAILABLE
     </div>
     <div class="ink-status-meaning">We're temporarily offline for maintenance. Please try again later.
     </div>
   </div>
</div>

<style>
  .ink-statuses-wrapper {
     border: 1px solid #c4c4c4;
     border-radius: 4px;
     padding: 15px;
  } 
 .ink-status-item {
   display: flex;
   align-items: center;
   font-weight: 300;
     font-size: 16px;
 }
  
  .ink-status-item>*{
    margin-bottom: 15px;
  }
  
 .ink-status-item:last-child>* {
    margin-bottom: 0;
  }
  
 .ink-status-label {
   margin-right: 15px;
   min-width: 192px;
 }
 

 .ink-status-label.success {
   color: #19d686;
 }
  
   .ink-status-code.success {
     background: #19d686;
  }
  
.ink-status-label.failure {
   color: #ee4545;
}
  
  .ink-status-code.failure {
    background: #ee4545;
  }
 
.ink-status-code {
  padding: 3px 5px;
  border-radius: 5px;
  border: 1px solid transparent;
  margin-right: 5px;
}
  
</style>
`}</HTMLBlock>

## Questions?

<span class="ink-question">
  We're always happy to help with code or other questions you might have. [Search our documentation](https://docs.inkit.com/search?q=Inkit), [check the help center](https://help.inkit.com/hc/en-us), or [connect with our sales team](http://www.inkit.com/demo). <br />
  Ask questions to our support team ([[email protected]](mailto:[email protected])) if you run into any technical roadblock or the links above are not helpful.
</span>