Leads

List Leads

The store's leads, newest first.

GET https://rassmi.com/api/v1/leads

Authorization

Authorizationheaderrequired

Bearer rsk_…: the store's API key, from API Key in your Rassmi dashboard.

Query parameters

phone string

Find a lead by phone, any format.
created_since datetime

Only leads added at or after this time.
per_page integer

Results per page, 1 to 100. Default 15.

Responses

Status	Meaning
`200`	Success. The body is shown on the right.
`401`	Missing, unknown, paused or expired API key.
`429`	More than 60 requests in a minute. See Rate limits.

GET /leads

curl -X GET "https://rassmi.com/api/v1/leads" \
  -H "Authorization: Bearer $RASSMI_API_KEY" \
  -H "Accept: application/json"

use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('RASSMI_API_KEY'))
    ->acceptJson()
    ->get('https://rassmi.com/api/v1/leads');

$data = $response->json();

const response = await fetch('https://rassmi.com/api/v1/leads', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.RASSMI_API_KEY}`,
    Accept: 'application/json',
  },
});

const data = await response.json();

import os
import requests

response = requests.request(
    "GET",
    "https://rassmi.com/api/v1/leads",
    headers={"Authorization": f"Bearer {os.environ['RASSMI_API_KEY']}"},
)

data = response.json()

Response · 200

{
    "data": [
        {
            "id": 5521,
            "name": "Karim Haddad",
            "phone": "0661234567",
            "email": null,
            "wilaya": "31",
            "commune": "Oran",
            "address": null,
            "status": "new",
            "notes": null,
            "created_at": "2026-10-30T08:02:19+00:00"
        }
    ],
    "links": {
        "first": "https://rassmi.com/api/v1/…?page=1",
        "last": "https://rassmi.com/api/v1/…?page=4",
        "prev": null,
        "next": "https://rassmi.com/api/v1/…?page=2"
    },
    "meta": {
        "current_page": 1,
        "last_page": 4,
        "per_page": 15,
        "total": 52
    }
}