Get PUDO Points

This guide explains how to retrieve a list of published PUDO (Pick Up Drop Off) points using the Nowpost API.

Endpoint

GET /public/pudo-points

Authentication

This endpoint is publicly accessible and does not require authentication.

Headers:

Content-Type: application/json

Query Parameters

You can filter, search, and paginate PUDO points using the following query parameters:

• page (int, optional): Page number (default: 1)
• pageSize (int, optional): Page size (default: 10, maximum: 2000)
• search (string, optional): Search term to filter PUDO points by name or description
• sortBy (string, optional): Sort field
• sortOrder (string, optional): Sort order (asc or desc)
• latitude (number, optional): Latitude for nearby search (requires longitude)
• longitude (number, optional): Longitude for nearby search (requires latitude)

Example Request

GET /public/pudo-points?page=1&pageSize=20&search=pharmacy&sortBy=name&sortOrder=asc&latitude=6.5244&longitude=3.3792

Response

200 OK

{
  "data": {
    "data": [
      {
        "id": "pudo-point-id",
        "name": "Main Street Pharmacy",
        "description": "Convenient pickup location in the heart of downtown",
        "address": {
          "id": "address-id",
          "label": "PUDO_POINT",
          "address": "123 Main Street",
          "city": "Lagos",
          "state": "Lagos",
          "zip": "100001",
          "country": "Nigeria",
          "latitude": 6.5244,
          "longitude": 3.3792,
          "verified": true
        },
        "partner": {
          "id": "partner-id",
          "name": "Downtown Pharmacy Ltd",
          "type": "pharmacy",
          "email": "contact@pharmacy.com",
          "phone": "+234-xxx-xxx-xxxx",
          "website": "https://pharmacy.com"
        },
        "status": "approved",
        "note": "Available for pickups during business hours",
        "published": true,
        "createdAt": "2025-08-12T12:00:00Z",
        "updatedAt": "2025-09-01T10:30:00Z",
        "deletedAt": null,
        "workingHours": {
          "openingMonday": "08:00",
          "closingMonday": "18:00",
          "openingTuesday": "08:00",
          "closingTuesday": "18:00",
          "openingWednesday": "08:00",
          "closingWednesday": "18:00",
          "openingThursday": "08:00",
          "closingThursday": "18:00",
          "openingFriday": "08:00",
          "closingFriday": "18:00",
          "openingSaturday": "09:00",
          "closingSaturday": "16:00",
          "openingSunday": null,
          "closingSunday": null
        },
        "minItemWeight": 0.1,
        "maxItemWeight": 50.0,
        "maxItemValue": 500000
      }
    ],
    "pagination": {
      "totalCount": 150,
      "page": 1,
      "pageSize": 20,
      "totalPages": 8
    }
  }
}

Response Fields

PUDO Point Object

• id: Unique identifier for the PUDO point
• name: Display name of the PUDO point
• description: Description of the PUDO point location/service
• address: Address object with location details
• partner: Partner information who operates this PUDO point
• status: Current status (pending, approved, rejected)
• note: Additional notes about the PUDO point
• published: Whether the PUDO point is publicly visible
• createdAt: ISO 8601 timestamp when created
• updatedAt: ISO 8601 timestamp when last updated
• deletedAt: ISO 8601 timestamp when soft deleted (null if active)
• workingHours: Operating hours for each day of the week
• minItemWeight: Minimum item weight accepted (in kg)
• maxItemWeight: Maximum item weight accepted (in kg)
• maxItemValue: Maximum item value accepted (in Nigerian Naira)

Working Hours

Time format is HH:MM (24-hour format). null values indicate the location is closed on that day.

Error Responses

• 500 Internal Server Error: Server error retrieving PUDO points.

Use Cases

1. Find nearby PUDO points: Use latitude and longitude parameters to find PUDO points near a specific location
2. Search for specific locations: Use the search parameter to find PUDO points by name or description
3. Paginate through all locations: Use page and pageSize to browse through all available PUDO points

---

For more details, see the API Reference.