# Getting started with AmunCore

> Turn a database table into a secure REST API in five steps, with no backend code.

## No database yet? Try with sample data

On the Dashboard, Try with sample data adds one or more trades (Retail and POS, Distribution, Clinics, Real estate, Restaurants, HR and payroll, Schools, Manufacturing; English or Arabic): their tables as read-only endpoints in one application, a read-only API key, a ready assistant with its ready questions, and an App Builder app with its dashboards and an Ask page, both published for your team. The sample data is shared and read only; your own data is never touched. On your own server, the platform administrator builds it once under Demo Database (SQL Server recommended), and its dates move forward by themselves. A sample application made with the older two-table demo moves to the new sample data the next time a trade is added (its two older endpoints are removed).

## 1. Register an application

An application is a connection to one of your databases. In AmunCore open Applications, then New Application, and enter:

- Name: a friendly label, for example "Online Shop".
- App ID: a short URL-safe id, for example `shop`. It appears in your API URLs.
- Database provider: SQL Server, MySQL, MariaDB, PostgreSQL, Oracle or SQLite.
- Connection string: how AmunCore reaches the database. It is stored encrypted (AES-256).

When you save, AmunCore creates the application's API key. Keep it safe: it authenticates your calls.

## 2. Create an endpoint

An endpoint maps a table, a stored procedure, an external API or a Shape to a REST URL.

- Name: for example `customers`.
- Methods: GET (read), POST (create), PUT (update), DELETE (remove).
- Table and columns: load the tables, tick the columns to expose. The primary key is detected for you.
- Description: tells AI assistants what the endpoint is for. Recommended.

Bulk create makes one read endpoint per table for many tables at once.

## 3. Make the first call

```
curl https://amuncore.com/api/v1/shop/customers \
  -H "X-Api-Key: YOUR_API_KEY"
```

The Endpoints page has a Copy cURL button with your real app ID and key filled in, and the API Console tries any endpoint in the browser.

## 4. Filter and page

```
GET /api/v1/shop/customers?Status=active&page=1&pageSize=20
GET /api/v1/shop/customers/42
```

## 5. Go further

- [REST API reference](https://amuncore.com/docs/rest-api.md): methods, filters, errors, GraphQL-style queries and webhooks.
- [AI access over MCP](https://amuncore.com/docs/mcp.md): let Claude, ChatGPT or another assistant use the same endpoints.
- [App Builder](https://amuncore.com/docs/app-builder.md): dashboards and report pages from your endpoints.
- [AI agents](https://amuncore.com/docs/agents.md): scheduled reports, alerts and chat apps.
- [Security and access control](https://amuncore.com/docs/security.md): keys, row rules, approvals and audit.

Back to the [AmunCore overview](https://amuncore.com/llms.txt).
