Introduction
Overview
The Rassmi Developer Platform connects your store, app or ERP to Rassmi, the Algerian marketplace where independent agents confirm cash-on-delivery orders by phone.
What the API does
Send orders to your agents' call queue, follow every confirmation, keep products and stock in sync, and receive each change the moment it happens with webhooks. The API is REST over HTTPS, answers JSON, and authenticates every request with your store's API key.
QuickstartYour first order in Rassmi in three requests.
Orders APIImport, correct, follow and cancel COD orders.
Webhooks19 events, signed and retried.
AuthenticationOne API key per store, sent as a Bearer token.
Base URL
https://rassmi.com/api/v1
Every path in this reference is relative to it, for example GET /orders is https://rassmi.com/api/v1/orders.
Conventions
- Requests and responses are JSON, UTF-8. Send
Accept: application/json, andContent-Type: application/jsonwith a body. - IDs of orders, products and webhooks are UUIDs; leads and variants use numbers.
- Times are ISO 8601 in UTC (
2026-10-30T09:12:44+00:00). Amounts are numbers in Algerian dinars (DZD). - Phone numbers can be sent in any common Algerian format (
0555 12 34 56,+213555123456); Rassmi stores them as0XXXXXXXXX. - Wilayas are accepted as a code (
16) or a name in French or Arabic; see List Wilayas.
Order statuses
| Status | Meaning |
|---|---|
pending_confirmation | Waiting in the agents' call queue. |
call_back | The customer asked to be called again later. |
confirmed | Confirmed by an agent after an answered call. |
processing | Being prepared for shipping. |
shipped | Handed to the delivery company. |
delivered | Delivered and paid. |
returned | The parcel came back. |
canceled | Cancelled by the customer, the store or the API. |
fake | Marked as fake or spam by the agent. |