PUDO Locations API

Introduction

This endpoint returns a list of PUDO (Pick-Up/Drop-Off) locations. You can filter results by city.

Request and Response

This API only accepts GET requests.

Development API End Point URL

https://dev-api.aymakan.com.sa/v2/pudo/locations?city=Riyadh

Production API End Point URL

https://api.aymakan.net/v2/pudo/locations?city=Riyadh

Query Parameters

  • city (string, optional): Filter locations by city (example: Riyadh)

Headers

The following headers should be sent along with the request:

  • Accept: application/json
  • Authorization: Your account security code / Api Token

Response

Success Response

Upon successful request, the following response will be sent back with an HTTP status 200 OK.


{
  "success": true,
  "message": "PUDO location retrieved successfully",
  "data": [
    {
      "id": 1,
      "address": "Near Shawarma Hawari, Al Qana Street, Yasmin, Riyadh",
      "city": "Riyadh",
      "description": "Adam Pharmacy",
      "host_name_ar": "صيدلية ادم",
      "host_name_en": "Adam Pharmacy",
      "lat": "24.83386100",
      "lng": "46.65227800",
      "point_id": "201866",
      "point_name": "Adam Pharmacy",
      "postal_code": "",
      "provider": "fodel",
      "street": "",
      "type": "pickup_point",
      "working_hours": {
        "friday": "08:00-03:00",
        "monday": "08:00-03:00",
        "saturday": "08:00-03:00",
        "sunday": "08:00-03:00",
        "thursday": "08:00-03:00",
        "tuesday": "08:00-03:00",
        "wednesday": "08:00-03:00"
      }
    },
    {
      "id": 2,
      "address": "Near Mcdonalds, Prince Mahmood Bin Abdul Aziz Street, Sulaimania, Riyadh",
      "city": "Riyadh",
      "description": "Adam pharmacy",
      "host_name_ar": "صيدلية ادم",
      "host_name_en": "Adam pharmacy",
      "lat": "24.71200000",
      "lng": "46.69652800",
      "point_id": "201852",
      "point_name": "Adam pharmacy",
      "postal_code": "",
      "provider": "fodel",
      "street": "",
      "type": "pickup_point",
      "working_hours": {
        "friday": "06:00-03:00",
        "monday": "06:00-03:00",
        "saturday": "06:00-03:00",
        "sunday": "06:00-03:00",
        "thursday": "06:00-03:00",
        "tuesday": "06:00-03:00",
        "wednesday": "06:00-03:00"
      }
    }
  ]
}