GET /markets
No key needed
Public, no key needed. Each live market with its currency (amounts are integers in its minor unit), time zone, phone format, identity documents, address fields and the products sold there. Ghana (GH) is the only live market; every market is a separate domestic network and parcels never cross markets.
Node.js cURL PHP Python
Copy Request
import { QoeneDelivery } from '@qoene/delivery' ;
const qoene = new QoeneDelivery({ apiKey: process.env.QOENE_API_KEY! });
const result = await qoene.markets.list();curl https://api.qoenedelivery.com/v1/markets<?php
require 'vendor/autoload.php' ; // composer require guzzlehttp/guzzle
$client = new GuzzleHttp\Client([
'base_uri' => 'https://api.qoenedelivery.com/v1/' ,
'timeout' => 30 ,
]);
$response = $client ->get('markets' );
$data = json_decode((string) $response ->getBody(), true )['data' ];import os
import requests
response = requests.get(
"https://api.qoenedelivery.com/v1/markets" ,
timeout=30 ,
)
response.raise_for_status()
data = response.json()["data" ]Response 200 Copy {
"status" : "success" ,
"data" : {
"markets" : [
{
"code" : "GH" ,
"name" : "Ghana" ,
"status" : "LIVE" ,
"timezone" : "Africa/Accra" ,
"currency" : {
"code" : "GHS" ,
"minorUnit" : 2 ,
"symbol" : "GH₵"
},
"locales" : [
"en-GH"
],
"defaultLocale" : "en-GH" ,
"phone" : {
"countryCode" : "233" ,
"nationalLength" : 9 ,
"trunkPrefix" : "0" ,
"example" : "024 123 4567"
},
"identityDocuments" : [
{
"type" : "GHANA_CARD" ,
"name" : "Ghana Card"
}
],
"address" : {
"fields" : [
"line1" ,
"area" ,
"city" ,
"region"
],
"postcode" : {
"name" : "Ghana Post GPS" ,
"required" : false
}
},
"support" : {
"email" : "[email protected] " ,
"phone" : null ,
"whatsapp" : null ,
"hours" : "Mon–Sat 08:00–18:00"
},
"products" : [
"EXPRESS_STANDARD" ,
"EXPRESS_PRIORITY" ,
"RELAY_POINT" ,
"RELAY_LOCKER" ,
"RELAY_HOME"
]
}
]
}
}# RequestNo parameters.
# ResponseSuccess responses Status Meaning 200Live markets
The body is { "status": "success", "data": … }. Fields of data (MarketList ):
Response data Field Type Description marketsRequired array of Market
# ErrorsErrors use the error envelope { "status": "error", "message", "code"?, "details"? }.
Error responses Status When 429Too many requests. See the RateLimit headers. Too many requests. Wait for Retry-After, then retry with the same idempotency key.