Flype Order API
  1. Locations
  • Flype Order API
    • Introduction
    • Shipments
      • Rates
      • Create Bulk Orders
      • All Shipments
      • Shipments Count
      • Shipment Details
      • Shipment Last Status
      • Cancel Shipment
      • Get Shipping Label
    • Webhook
      • Webhook: Shipment status updates (Flype → Your Server)
    • Locations
      • Upsert Pickup Location
        POST
      • Get Saved Pickup Locations
        GET
      • Fetch Pickup Location Details
        GET
    • Schemas
      • ApiStatus
      • ErrorResponse
      • ShipmentsCountResponse
      • AllShipmentsRequest
      • ShipmentSummary
      • AllShipmentsResponse
      • BulkOrderRequest
      • BulkOrderResponse
      • SchedulePickupRequest
      • SchedulePickupResponse
      • City
      • GetCitiesResponse
      • ShipmentDetailsResponse
      • ShipmentLastStatusResponse
      • CancelShipmentResponse
      • LabelResponse
      • Country
      • CountriesResponse
      • ShipmentStatusWebhook
      • PlaceBulkItem
      • SuccessMessageResponse
      • PlaceBulkAddress
      • BooleanDataResponse
      • PlaceBulkPickupLocation
      • ShipmentAddress
      • PlaceBulkShipment
      • ShipmentRecipient
      • PlaceBulkAcceptedOrder
      • ShipmentRetailerAddress
      • PlaceBulkDeniedOrder
      • ShipmentRetailer
      • BulkOrderResponseData
      • ShipmentDriver
      • ShipmentStatusHistoryEntry
      • DeliverySettings
      • DropOffDetails
      • AllShipmentsItem
      • CitiesResponse
      • AirwayBillResponse
      • WebhookShipmentStatusUpdate
      • WebhookAckResponse
      • PlaceBulkDeliveryAddress
      • PlaceBulkRequest
  1. Locations

Get Saved Pickup Locations

GET
/locations

Get Saved Pickup Locations - List registered pickup locations#

Use this endpoint to retrieve pickup locations saved in Flype for the authenticated account.
This endpoint can be used to verify registered locations, check location status, and retrieve location identifiers for order creation.

When to use this endpoint#

  • To list pickup locations registered with Flype.
  • To confirm the correct externalLocationId before creating orders.
  • To check whether a location is active or inactive.
  • To audit or troubleshoot pickup location setup.

Pagination#

  • offset controls the starting index.
  • limit controls the number of records returned.

Important notes#

  • If no locations match, data will be returned as an empty array.
  • Inactive locations may not be usable for rates or shipment creation.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/locations?offset=0&limit=50' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
Bodyapplication/json

Examples
{
  "status": "success",
  "data": [
    {
      "externalLocationId": "STORE_123",
      "name": "Store Name - Downtown",
      "status": "ACTIVE",
      "address": {
        "street1": "123 Main St",
        "street2": "Suite 10",
        "city": "New York",
        "postalCode": "10001",
        "country": "United States"
      },
      "contact": {
        "name": "Pickup Desk",
        "phone": "+1-212-555-0101"
      },
      "createdAtUtc": "2026-02-01T12:10:00Z"
    },
    {
      "externalLocationId": "STORE_567",
      "name": "Manhattan",
      "status": "INACTIVE",
      "address": {
        "street1": "235 West 56th street",
        "street2": "Building 1",
        "city": "New York",
        "postalCode": "10019",
        "country": "United States"
      },
      "contact": {
        "name": "Pickup Desk",
        "phone": "+1-212-555-0101"
      },
      "createdAtUtc": "2026-01-15T11:10:00Z"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 50,
    "total": 2
  }
}
🟠401
🟠400
Previous
Upsert Pickup Location
Next
Fetch Pickup Location Details
Built with