Get Current Orders

curl --request GET \
  --url https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current \
  --header 'Access-Token: <api-key>'

import requests

url = "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current"

headers = {"Access-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'Access-Token': '<api-key>'}};

fetch('https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": false,
  "error": "çok fazla istek",
  "message": "Çok fazla istek. Lütfen 30 saniye bekleyin."
}

{
  "status": false,
  "error": "yetkisiz erişim",
  "message": "Invalid or expired access token"
}

GET

orders

get-current

Get Current Orders

curl --request GET \
  --url https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current \
  --header 'Access-Token: <api-key>'

import requests

url = "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current"

headers = {"Access-Token": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'Access-Token': '<api-key>'}};

fetch('https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "status": false,
  "error": "çok fazla istek",
  "message": "Çok fazla istek. Lütfen 30 saniye bekleyin."
}

{
  "status": false,
  "error": "yetkisiz erişim",
  "message": "Invalid or expired access token"
}

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.

Authentication

string

required

Your API access token

Query Parameters

integer

Filter by specific status ID (see Order Status Codes)

Response

boolean

required

Indicates if the request was successful

array

required

Array of active order objects

Show Order Object

integer

External order ID (for display purposes)

string

Internal order UUID - use this for all operational API calls

integer

Current order status code (1: Received, 2: Confirmed, 16: In Delivery, etc.)

string

Human-readable status description

string

"delivery" or "pickup"

string

Payment type (e.g., “Nakit”, “Kredi Kartı”)

number

Final amount to collect (after discounts)

string

Total discount amount applied

string

"restaurant" | "fuudy" | "come_get"

object

Show Customer Details

string

Customer name

string

Customer phone number

object

Show Delivery Address

string

Street name

string

Building number

string

Apartment number

string

Neighborhood

string

District

string

City

array

Array of ordered items with modifiers

Show Order Item

string

Order item UUID

integer

Product ID

string

Product name

integer

Quantity ordered

number

Unit price

number

Line total (price × quantity + modifiers)

array

Selected modifiers

Examples

curl -X GET 'https://www.xn--dkkango-n2a.com/api/integrations/orders/get-current' \
  -H 'Access-Token: your-access-token'

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();

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

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

{
  "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

First Call

When you call /get-current, new orders appear in the response.

Order Repetition

Orders continue to appear in subsequent calls until acknowledged.

Acknowledge

Call /orders/success/{payment_key} to acknowledge.

Status Changes

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

{
  "status": false,
  "error": "çok fazla istek",
  "message": "Çok fazla istek. Lütfen 30 saniye bekleyin."
}

{
  "status": false,
  "error": "yetkisiz erişim",
  "message": "Invalid or expired access token"
}

Typical Integration Pattern

// 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

Acknowledge Order

Mark order as received

Accept Order

Accept and set preparation time

Order Lifecycle

Complete order flow guide

Best Practices

Integration best practices

​Overview

​Authentication

​Query Parameters

​Response

​Examples

​With Status Filter

​Response Example

​Important Behavior

​Error Responses

​Typical Integration Pattern

​Next Steps

Acknowledge Order

Accept Order

Order Lifecycle

Best Practices

Overview

Authentication

Query Parameters

Response

Examples

With Status Filter

Response Example

Important Behavior

Error Responses

Typical Integration Pattern

Next Steps