How to Search Contracts From Chat With the LegalOn API | From Checking the Text to Registering Contracts

Every time someone asks, "How was the renewal clause written in our contract with that company?", you search for the contract in LegalOn, open it, and reread the clause. The more often sales or accounting ask, the more legal's work stalls. This article is for legal and administration staff who manage contracts in LegalOn, and lays out the steps for searching contracts, checking their text, and registering new contract files from chat.

Interpreting clauses and judging contract risk is not the role of this integration. The AI returns where in the text something is written, and the person in charge makes the judgment.

Conclusion

  • LegalOn has an official API. On July 13, 2026, an API was released that can upload contract files, list and fetch details of registered contracts, update contract information, delete contracts, and register related files
  • Each user issues their own API credential in LegalOn under [Personal settings] → [API integration]. What it can do is the same as the permissions that person has in LegalOn
  • Samurai App's LegalOn integration is used by each member registering their own API credential. From chat, you can search contracts, check their text, list versions, update contract information, and register contracts
  • Deleting, registering related files, and adding a new version to an existing contract are not possible. Do these in the LegalOn screens

Three Ways to Search LegalOn Contracts

LegalOn screens Calling the API yourself Calling it from AI chat
What you need A LegalOn account An API credential and development work An API credential and Samurai App
How you search Search and filters on the screen Write a program Ask in words
Checking the text A person opens and reads it Extract it in a program Extracts and returns the clauses
What you can see Your own permissions The permissions of the user tied to the credential Same as left

Searching in the LegalOn screens is the basis. If legal staff search for themselves, that is enough.

Calling the API yourself lets you register and fetch contracts from your own systems, such as a contract management system or CRM. According to LegalOn's developer documentation, authentication uses the OAuth 2.0 Client Credentials Flow, and the API endpoint differs by contract region (Japan or United States). You can only operate within the workspaces where the user has a role.

Calling it from AI chat uses the same API without writing a program. Samurai App falls into this category.

What You Can and Cannot Do With Samurai App

The six operations listed under "What you can do from chat" on the settings screen are everything.

Viewing

  • List the workspaces and folders you can see. The hierarchy is returned too
  • Search contracts in a folder. Title and counterparty are partial matches, and you can also filter by contract type or governing law. Up to 100 per request (50 if not specified), with the rest read as the next page. The latest version of each contract is returned
  • Open a single contract to see its counterparty, contract type, status, and related files. If you ask, it also reads the text. Text beyond 60,000 characters is cut off
  • View a contract's list of versions, oldest first

Updating and registering (by default, an approval card appears before running)

  • Update a contract's information (title, language, your side's and the counterparty's parties, contract type, status). Only the fields to change are sent. List fields such as parties are replaced entirely by the list you send
  • Register a file attached to the conversation, or a file from a folder you can read, as a new contract. You choose whether it is pre-execution or executed. Files up to 100MB can be sent

What it cannot do

  • Delete contracts
  • Register related files (appendices, memoranda, and so on) and link them to the contract
  • Add a new version to an existing contract. Registering always creates a new contract
  • Manage LegalOn users, groups, or permissions
  • Operate with someone else's permissions. LegalOn refuses access to contracts the user cannot see in LegalOn

A newly registered contract needs a short wait while LegalOn reads the counterparty and other information. You can tell whether the reading is done from the status when you open the contract.

Searching Contracts by Counterparty and Reading the Text

This is how you answer internal questions like "What did our contract with this company say?" in chat.

  • Search by counterparty. Ask, "In LegalOn's 'Clients' folder, list the contracts whose counterparty contains 'Sample'. Make a table of the title, contract type, and status"
  • Extract clauses from the text. Point to one contract in the list and ask, "Extract the clauses on the contract term, renewal, and termination from this contract's text, verbatim. Include the clause numbers." Asking for verbatim extracts rather than a summary makes it easier to check against the original contract
  • See differences between versions. Ask, "Show me this contract's list of versions," then specify two versions and have it read their text to see side by side what changed

Long contracts whose text exceeds 60,000 characters are cut off partway. When that happens, it tells you so, and you check the rest in the LegalOn screens.

Registering a Contract You Received

You can attach a contract file received from a counterparty to the chat and register it.

Register the attached contract in LegalOn's "Clients" folder as a pre-execution contract

Once it is registered, wait a little and check the counterparty and contract type that were read. If the reading is wrong, have it correct it right there.

Open the contract I just registered and show me the counterparty and contract type that were read.
If the counterparty is wrong, change it to "Sample Co., Ltd."

What You Need

  • A LegalOn contract, and a LegalOn account for each member who will use it from chat
  • An administrator or manager in Samurai App (the person who enables LegalOn)
  • Your company's region. You can check it under "License" in LegalOn's admin settings

Steps

1. An Administrator Enables LegalOn

Open the "Connectors" screen (/settings/connections), and choose LegalOn from "Add API integration" on the "API integrations" tab. Choose "Japan" or "United States" under "Region," and press "Enable LegalOn."

The administrator enters only the region. No company-wide key is entered.

2. Each Member Registers Their Own API Credential

  1. Issue an API credential in LegalOn under [Personal settings] → [API integration]. You can choose an expiry of 7 days, 30 days, 60 days, a custom number of days, or no expiry
  2. Copy the issued value. It is shown only when issued
  3. Open LegalOn on Samurai App's "API integrations" tab, paste it into the "API credential" field, and press "Register LegalOn API credential"

When "Registered" and a date appear, you are done. For an administrator to use it from chat as well, they register their own credential in the same way.

With this value, anyone can read and write LegalOn contracts with the permissions of the person who issued it. Do not give it to others, and do not paste it into the chat input either.

3. Ask in Chat

First, check which folders you can see.

List the LegalOn workspaces and folders I can see

Then ask for a search, specifying the folder and counterparty.

In the "Clients" folder, list the contracts whose counterparty contains "Sample".
From the text of the newest one, extract the damages clause verbatim

When you ask it to update contract information or register a contract, by default an approval card appears before it runs. Check the target contract and what will change before allowing it.

Notes

Register again when it expires. When an API credential expires or is revoked, you can no longer use it from chat. Issue a new one in LegalOn and register it as in step 2. You can remove your own registration with "Delete LegalOn API credential registration."

When an administrator disables LegalOn, everyone's registration is deleted. To use it again, each person registers again. Even then, the contracts in LegalOn themselves remain.

Check the AI's extracts against the original contract. The text is read clause by clause, but the accuracy of extracts or paraphrases is not guaranteed. Before using them for external answers or decisions, check the original in the LegalOn screens.

What you can see is determined by your LegalOn permissions. A contract you cannot find by searching in chat may be one you do not have permission to see. Change permission settings on the LegalOn side.

Frequently Asked Questions

Which LegalOn plans can use the API?

As of November 9, 2026, LegalOn's announcement and developer documentation did not state which plans can use the API. Check with LegalOn whether your contract allows it.

Can I ask for a contract review from chat?

This integration does not run LegalOn's review feature. What it can do is search contracts, check their text, update contract information, and register contracts. You can have it read the text and extract clauses, but the person in charge judges whether the content is good or bad.

Can it handle contracts executed with CloudSign?

It can, if they are registered in LegalOn. The steps for checking CloudSign document information (counterparty, contract term, transaction amount) in chat are explained in How to search executed contracts from chat with the CloudSign API.

Can I use it in the United States region?

Yes. Choose "United States" when the administrator enables it. You can check the region under "License" in LegalOn's admin settings.

Sources

Based on LegalOn Technologies' announcement and the LegalOn API Reference as checked on November 9, 2026.

Related featureConnect business tools to AI over MCPSamurai App connects your business tools to AI over MCP. Operate accounting and HR SaaS from chat within each person's own permissions, call the agent from Slack or Teams, and use it from outside AI clients over MCP.

More automation examples

    Back to How-to articles

    Everyday work comes together, connects, and becomes the company's strength.

    Contact usOpen Samurai App

    See the demoContact us