The store API

The store API: read the orders list by status and date

The reference for the orders address of the ArabyBot store API: filtering by status and date, paging, the order's shape, and the refusals.

4 min read Updated 16 November 2026 ArabyBot team
The ArabyBot teamOfficial Meta partner · written from our own platform data
On this page 7
  1. The address and authentication
  2. The fields
  3. An example request
  4. The response
  5. The refusals
  6. The limits
  7. Frequently asked questions

The short answer

With a GET request to the orders address of the store API. The response returns the orders, newest first, fifty a page, and you can filter them by status and by a start date. Every order comes back with its full details: the customer, the address, the items, the amounts and the shipping. The has_more field says whether there is a next page.

Also asked as: «اسحب طلبات المتجر على شيت او سيستم» · «api الطلبات» · «get store orders via api»

The address and authentication

GET https://app.arabybot.com/store_api/v1/orders

Send the store key in the header Authorization: Bearer abst_… or X-Api-Key. You create the key in the store settings; it is shown once and sees only its own store. This address accepts a read key or a write key.

The fields

  • status (optional) One status: new, confirmed, preparing, shipped, delivered, returned or cancelled.
  • since (optional) A start date, e.g. 2026-11-01; orders created from then on come back.
  • page (optional) The page number, starting at 1. A page holds 50 orders.

An example request

cURL

curl "https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1" \
  -H "Authorization: Bearer abst_YOUR_STORE_KEY"

PHP

$ch = curl_init('https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer abst_YOUR_STORE_KEY'],
]);
$answer = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

Python

import requests

r = requests.get(
    'https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1',
    headers={
        "Authorization": "Bearer abst_YOUR_STORE_KEY",
    },
    timeout=30,
)
print(r.status_code, r.json())

Node.js

// Node.js 18+
const r = await fetch('https://app.arabybot.com/store_api/v1/orders?status=new&since=2026-11-01&page=1', {
  headers: {"Authorization": "Bearer abst_YOUR_STORE_KEY"},
});
console.log(r.status, await r.json());

The response

200
{ "ok": true, "orders": [ { "id": 9041, "number": "1042", "status": "new", "total": 530.0, "…": "…" } ],
  "page": 1, "has_more": false }
  • Every element of orders is a full order in the same shape the single-order address returns.
  • has_more is true when there is a next page; ask for it by raising page.
ArabyBot's API as it runs today, read from the system itselfmeasured 16 November 2026

The refusals

Every refusal comes back as JSON with "ok": false and the code in error:

  • 422 bad_status: The status value is not one of the seven statuses.
  • 422 bad_since: The since value is not a date that can be read.
  • 401 unauthorized: The key is missing, wrong or revoked.
  • 402 store_plan_closed: The store plan has ended; renew it.
  • 429: More than 120 requests in a minute.
  • 500 server_error: A failure on our side; try again.

The limits

120 requests a minute from one IP address; passing that returns status 429. A store can have up to five keys. A key sees only its own store, and the store's plan must be active.

All store API addresses · All APIs for developers

Frequently asked questions

1

How do I pull only the new orders each time?

Send the time of your last successful pull in since, or use the store's webhooks so orders reach you the moment they are created, with no polling.

2

How many orders come back at a time?

Fifty a page, newest first. The has_more field says whether there is a next page.

The ArabyBot teamOfficial Meta business partner in the Middle East 264 guides Figures from our platform All guides

How we write these guides Figures come from our platform and Meta's actual invoices, dated with their sample; we describe what works today, not what we plan, and say what we do not do and when someone else is the better choice. Reviewed by the ArabyBot team on 16 November 2026.

Share this guide

Try the agent before you pay anything

The agent that will answer your customers is the one answering you now: ask it from the chat button here or on WhatsApp. Your account is free with no credit card, and the free trial on your own number or page is activated after you contact our team on customer-service WhatsApp.

And you run all of it from your phoneEverything on this page is also run from the ArabyBot mobile app — replies, orders, campaigns and AI reports. Not a web dashboard only.