# Getting started

> Make your first request in 3 steps. Two paths: the Platform API for developers building their own product, the Business API for a business reading its own data.

There are two journeys. Which one is yours?

- **I am building my own product** (an app, an agency panel, a SaaS): follow the Platform API, the first half of this page is yours.
- **I want my own café's data** (reports, integrations, automation): follow the Business API, the second half is yours.

## Path 1: your own product on the Platform API

### 1. Sign up and get your key

Sign up at [app.sadakio.com/gelistirici/kayit](https://app.sadakio.com/gelistirici/kayit). No company required, no human approval to wait for. Signup provisions your first business too, so your first call is real rather than a rehearsal. Your `pk_` key is shown once, store it somewhere safe.

### 2. List your businesses

```
curl https://api.sadakio.com/platform/v1/businesses \
  -H "Authorization: Bearer pk_YOUR_KEY"
```

The response holds the business created at signup, and its `join_url` is your guests' sign-up page.

### 3. Register a guest and give a stamp

```
curl -X POST https://api.sadakio.com/platform/v1/businesses/BIZ_ID/guests \
  -H "Authorization: Bearer pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+905551112233", "name": "Elif"}'

curl -X POST https://api.sadakio.com/platform/v1/businesses/BIZ_ID/guests/GUEST_ID/adjust \
  -H "Authorization: Bearer pk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-stamp-1" \
  -d '{"counter": "damga", "delta": 1}'
```

That is all. The guest is registered, the stamp is on, and resending the same request answers `replayed: true` with the same result, nothing is ever counted twice. Continue with the [Platform API reference](/en/docs/platform).

## Path 2: your own data over the Business API

### 1. Get your key from the panel

Open **Settings → API** in your Sadakio account and create your `sk_` key. The raw key is shown only once.

### 2. Fetch your guest list

```
curl https://api.sadakio.com/api/v1/guests \
  -H "Authorization: Bearer sk_YOUR_KEY"
```

Phones come back masked (KVKK) and the data belongs only to your business.

### 3. Get the retention summary

```
curl "https://api.sadakio.com/api/v1/stats/retention?period=month" \
  -H "Authorization: Bearer sk_YOUR_KEY"
```

Continue with the [Business API reference](/en/docs/api).

## Hand it to your assistant

Using Cursor, Claude or ChatGPT? Paste this prompt:

```
Build an integration on Sadakio.
Full documentation: https://sadakio.com/llms-full-en.txt
Platform contract: https://api.sadakio.com/platform/v1/openapi.yaml
Business contract: https://api.sadakio.com/api/v1/openapi.yaml
My key is ready. Build me [describe what you want].
```