> ## Documentation Index
> Fetch the complete documentation index at: https://dkkangoyazlmteknolojiticareta.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Current Orders
> Fetch all active orders that need attention
**Rate Limited:** This endpoint has a 30-second cooldown between requests.
## Overview
Fetches all active orders in statuses: `RECEIVED`, `CONFIRMED`, `IN_DELIVERY`, or `COMPLETE_NEEDS_PAYMENT`.
**Important:** Orders will repeat in subsequent calls until acknowledged via [`/orders/success`](/api-reference/orders/success).
## Authentication
Your API access token
## Query Parameters
Filter by specific status ID (see [Order Status Codes](/guides/order-lifecycle#order-status-codes))
## Response
Indicates if the request was successful
Array of active order objects
External order ID (for display purposes)
Internal order UUID - **use this for all operational API calls**
Current order status code (1: Received, 2: Confirmed, 16: In Delivery, etc.)
Human-readable status description
`"delivery"` or `"pickup"`
Payment type (e.g., "Nakit", "Kredi Kartı")
Final amount to collect (after discounts)
Total discount amount applied
`"restaurant"` | `"fuudy"` | `"come_get"`
Customer name
Customer phone number
Street name
Building number
Apartment number
Neighborhood
District
City
Array of ordered items with modifiers
Order item UUID
Product ID
Product name
Quantity ordered
Unit price
Line total (price × quantity + modifiers)
Selected modifiers
## Examples
```bash cURL theme={null}
curl -X GET 'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current' \
-H 'Access-Token: your-access-token'
```
```javascript JavaScript theme={null}
const response = await fetch(
'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current',
{
headers: {
'Access-Token': 'your-access-token'
}
}
);
const data = await response.json();
```
```python Python theme={null}
import requests
response = requests.get(
'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current',
headers={'Access-Token': 'your-access-token'}
)
data = response.json()
```
### With Status Filter
```bash theme={null}
curl -X GET 'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current?status_id=1' \
-H 'Access-Token: your-access-token'
```
## Response Example
```json theme={null}
{
"status": true,
"data": [
{
"id": 1031,
"status_id": 1,
"status_text": "Sipariş Geldi",
"shipping_method": "delivery",
"payment_key": "3e9caf87-5cb7-4c4e-adcb-fc2ec54cf24e",
"payment_method": "Kredi Kartı",
"note": "",
"total": 1417.5,
"date": "2026-01-16 15:10:54",
"restaurant_id": "0ca1d2b1-a199-4960-8617-83a659d890c8",
"restaurant_name": "Halaskargazi Şube",
"courier_type": "restaurant",
"discount": "157.5",
"courier_fee": 0,
"scheduled_date": "",
"order_tip": 0,
"customer": {
"name": "Kerim Test",
"phone": "05335587642"
},
"address": {
"address": "Dershane Sokak",
"description": "",
"apartment_no": "A",
"building_no": "71",
"neighborhood_name": "Halaskargazi Mah",
"district_name": "Şişli",
"city_name": "İstanbul"
},
"foods": [
{
"id": "1e5c28b8-e53e-482c-9b30-86e99b049da3",
"food_id": 1,
"name": "Beef Burrito",
"note": "",
"price": 675,
"quantity": 1,
"total": 675,
"option_groups": [
{
"id": 6,
"name": "Sos Seçimi",
"type": "multi",
"operation": "+",
"options": {
"id": 4,
"name": "Ballı Hardal",
"price": 10
}
}
]
}
]
}
]
}
```
## Important Behavior
When you call `/get-current`, new orders appear in the response.
**Orders continue to appear** in subsequent calls until acknowledged.
Call [`/orders/success/{payment_key}`](/api-reference/orders/success) to acknowledge.
After acknowledgment, if the order status changes, it will appear again with the new status.
Always use the `payment_key` (UUID) for operational API calls, not the `id` (integer).
## Error Responses
```json Rate Limit Error (429) theme={null}
{
"status": false,
"error": "çok fazla istek",
"message": "Çok fazla istek. Lütfen 30 saniye bekleyin."
}
```
```json Authentication Error (401) theme={null}
{
"status": false,
"error": "yetkisiz erişim",
"message": "Invalid or expired access token"
}
```
## Typical Integration Pattern
```javascript theme={null}
// Poll every 30 seconds
setInterval(async () => {
try {
const response = await fetch(
'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current',
{ headers: { 'Access-Token': accessToken } }
);
const { data: orders } = await response.json();
for (const order of orders) {
// Process order in your POS
await processOrderInPOS(order);
// Acknowledge order
await fetch(
`https://www.xn--dkkango-n2a.com/api/integrations/orders/success/${order.payment_key}`,
{
method: 'PUT',
headers: { 'Access-Token': accessToken }
}
);
// Accept order with preparation time
await fetch(
`https://www.xn--dkkango-n2a.com/api/integrations/orders/accept/${order.payment_key}`,
{
method: 'PUT',
headers: {
'Access-Token': accessToken,
'Content-Type': 'application/json'
},
body: JSON.stringify({ preparing_time: 30 })
}
);
}
} catch (error) {
console.error('Error polling orders:', error);
}
}, 30000);
```
## Next Steps
Mark order as received
Accept and set preparation time
Complete order flow guide
Integration best practices