API Documentation

Current Version: 2.0

This API allows you to create and manage your orders with Tucia in a simple, programmatic way using conventional HTTP requests. The endpoints are intuitive and powerful, allowing you to easily make calls to retrieve information or to execute actions.

With this API, you are able to add Tucia's human-powered photo editing functionality to any application. This is especially useful for resellers who have their own websites or apps, and outsource the real editing service to Tucia.


Approve order

HTTP Request:

POST /orders/:order_id/approve

Approve (or close) a specific order when it is in "reviewing" status


Query Parameters:

Name Type Description



Anything you want us to know after the order is closed.


good job! I hope this editor will do my future orders when possible.

Example successful response:

    "errors": [],
    "data": {
      "order_id": "UVWXYZ123",
      "project_name": "John's wedding",
      "customer_id": 1234,
      "price": 3,
      "status": "closed",
      "revision": 2,
      "ordered_at": "2017-12-02T16:00:00+04:00",
      "closed_at": "2017-12-05T12:00:00+04:00"

Example error response:

    "errors": [
      "invalid order status"


If you have any questions or suggestions about this API, don't hesitate to let us know.