Getting started with Katana API

The first step towards integrating Katana into your app or website is to create a Katana Advanced (or higher) account. With an account you'll be able to:

• Obtain API keys so Katana can authenticate your integration’s API requests
• Make a test API request to confirm everything is working correctly

Create a Katana account

In order to use the Katana API, you'll need to have be on a Professional plan or higher. If you don't have an account yet, schedule a demo now.

Obtain your API key

Katana authenticates your API requests using API keys attached to your account. If an API key is incorrect, outdated, or missing, Katana will return a 401 error.

Generate a key

1. Log in to Katana and navigate to Settings > API > API keys
2. Clicking on + Add new API key will generate a pop-up
3. Inside the pop-up, copy your API key and (optionally) give the
   key a name/description

See more about authentication within the API reference.

Key security

Never use API keys in the frontend of your application. Doing so could make it possible for others to discover them in your source code and allow them to take unwanted control of your account. You should only use API keys on your server.

We also highly recommend removing and replacing API keys if a staff member with token access departs your company.

Make a test API request

To check that your setup is working correctly, make a test API request using your API key to list all sales orders

curl --request GET \
  --url https://api.katanamrp.com/v1/sales_orders \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <Your api key>'

If everything is correct, Katana will return an array of sales order objects.

{
    "data": [
        {
            "id": 1700504,
            "customer_id": 4684002,
            "order_no": "SO-1 [DEMO]",
            "source": "katana",
            "order_created_date": "2020-08-05T11:33:42.000Z",
            "delivery_date": "2020-08-05T11:33:42.000Z",
            "location_id": 19465,
            "picked_date": "2019-10-27T11:33:42.000Z",
            "invoicing_status": "notInvoiced",
            "created_at": "2021-02-04T07:40:24.754Z",
            "updated_at": "2021-02-04T11:40:02.855Z",
            "status": "NOT_SHIPPED",
            "additional_info": "",
            "sales_order_rows": [
                {
                    "id": 3711690,
                    "quantity": "1.00000",
                    "variant_id": 4162087,
                    "tax_rate_id": 53036,
                    "price_per_unit": "1250.0000000000",
                    "attributes": []
                }
            ]
        }
      ]
}

Once you've successfully made an API request, you’re ready to begin using Katana API.