# SMS.ir Verify API Examples

---

## Example 1 – Verify Code

### Request

```bash
curl --location 'https://api.sms.ir/v1/send/verify' \
--header 'Content-Type: application/json' \
--header 'x-api-key: APIKEY' \
--data '{
    "Mobile": "9124375365",
    "TemplateId": 823566,
    "Parameters": [
      {
        "Name": "CODE",
        "Value": "1234"
      }
    ]
  }'
```

### SMS Text

> کد تأیید خرید آسان: 1234  
> (این کد محرمانه است — لطفاً به کسی ندهید)  
> omidib.com

---

## Example 2 – Login Notification

### Request

```bash
curl --location 'https://api.sms.ir/v1/send/verify' \
--header 'Content-Type: application/json' \
--header 'x-api-key: APIKEY' \
--data '{
    "Mobile": "9124375365",
    "TemplateId": 440721,
    "Parameters": [
      {
        "Name": "MOBILE",
        "Value": "1234"
      },
      {
        "Name": "DATE",
        "Value": "1234"
      },
      {
        "Name": "TIME",
        "Value": "1234"
      },
      {
        "Name": "IP_ADDRESS",
        "Value": "192.168.1.1"
      }
    ]
  }'
```

### SMS Text

> کاربر گرامی با شماره 1234 در تاریخ 1234 ساعت 1234 وارد سامانه تأمین مالی جمعی امید شدید.
>
> اگر این ورود از طرف شما نبوده است، لطفاً سریعاً با پشتیبانی تماس بگیرید.  
> آی‌پی ورود: 192.168.1.1  
> سکوی تأمین مالی جمعی امید کراد  
> omidcf.ir

---

## Example 3 – Simple Verification

### Request

```bash
curl --location 'https://api.sms.ir/v1/send/verify' \
--header 'Content-Type: application/json' \
--header 'x-api-key: APIKEY' \
--data '{
    "Mobile": "9124375365",
    "TemplateId": 948435,
    "Parameters": [
      {
        "Name": "CODE",
        "Value": "1s234"
      }
    ]
  }'
```

### SMS Text

> کد تأیید: 1s234  
> امید کراد  
> omidcf.ir

---

# ✅ API Response (Successful Request)

```json
{
  "data": {
    "messageId": 348514517,
    "cost": 1
  },
  "status": 1,
  "message": "موفق"
}
```

---

## 🔎 Response Fields Explained

| Field       | Type    | Description               |
| ----------- | ------- | ------------------------- |
| `status`    | integer | 1 = Success               |
| `messageId` | integer | Unique ID of sent message |
| `cost`      | integer | SMS cost units            |
| `message`   | string  | Response message          |