# Tai Cloud API Documentation

This is the complete API documentation for connecting to the Tai Cloud API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Tai Cloud connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/taiCloud/actions/{actionSlug}/run
```

## Tai Cloud actions

- POST `create-bill-payment` Create Bill Payment
- POST `create-invoice-payment` Create Invoice Payment
- GET `customer-by-organization-id` Customer By Organization Id
- GET `customer-by-reference-number` Customer By Reference Number
- GET `get-bill` Get Bill
- GET `get-bill-by-shipment` Get Bill By Shipment
- GET `get-bill-payments-by-shipment` Get Bill Payments By Shipment
- GET `get-invoice` Get Invoice
- GET `get-invoice-payments-by-shipment-id` Get Invoice Payments by Shipment Id
- GET `get-invoices-by-shipment-id` Get Invoices by Shipment Id
- GET `get-shipment` Get Shipment
- GET `list-bill-payments` List Bill Payments
- GET `list-bills` List Bills
- GET `list-invoice-payments` List Invoice Payments
- GET `list-invoices` List Invoices
- PUT `update-invoice-sync-status` Update Invoice Sync Status