Getting your moving data into your CRM: API and CSV

What data comes from where?

Each tool returns only the data of the scopes you give your key; a field outside those scopes never appears in the response.

• Requests (requests_list, request_get — "Read requests" scope): status, channel, customer name and origin city. Results come in pages of at most 50 records.
• Customer contact details ("Customer contact details" scope): phone, email and full address are added to request responses only for a key that has this scope.
• Quotes (quotes_list — "Read quotes" scope): the quote's status, its final price (in TRY, USD, EUR or GBP, whichever your company works in, never converted), total volume (m³) and distance (km). The cost breakdown and margin are not shared.
• Inventory (CSV per job): item, room, quantity, dimensions, volume, weight and approval status, from the "Inventory (CSV)" link on the request page.

How do you create an API key?

The key is personal: it works with the permissions of the user who creates it, and each user can hold at most 10 active keys at a time.

Keys work for every company with an active plan; the keys of a user who leaves the team are revoked automatically.

• In the panel, open the Integrations page and go to "Create a new key" on the "AI assistants" card.
• Choose only what you need: for a CRM export, usually "Read requests", "Read quotes" and, if needed, "Customer contact details".
• Choose the lifetime: 30, 90, 180 or 365 days (default 90). The card warns you 7 days before it expires.
• Press "Create key" and copy the key right away: for your security it is not shown again. Store it in your automation tool's secret field; do not put it in an email or a shared document.

Example: fetching open requests

Every tool is called on a single endpoint: POST /api/v1/tools/<tool name>. The body is the tool's input; the key goes in the Authorization header. The request below fetches open (not closed) requests, newest first, in pages of 50:

curl -X POST https://loduvo.com/api/v1/tools/requests_list \
  -H "Authorization: Bearer $LODUVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"active","limit":50,"page":1}'

The response has the form {"ok": true, "data": …}; on error it returns "ok": false with an error code. GET /api/v1/tools lists the tools your key can actually call and their input schemas. Requests are rate limited; a request over the limit gets 429 with a response that says how long to wait.

Inventory as CSV

To attach a job's item list to a CRM record or to your accounts, use the "Inventory (CSV)" link on the request page. The file opens in the panel's language: English headings on an English panel, with the separator and decimal mark Excel expects.

• Columns: code, item, room, quantity, length, width, height (cm), volume (m³), weight (kg), fragile, special handling, approval status and note.
• CSV export is available on Growth and above.
• Each download gives the inventory as it is at that moment; download again after later corrections.

Setting up a regular export

Any automation tool that can send an HTTP request, or a small script of your own, can call requests_list at regular intervals and write new or changed records to your CRM. Loduvo does not push changes itself, so choose the interval to match the pace of your work, and match each request's id to the CRM record so the same record is not written twice.