Direct API

Fixed Locations

Get pickup points, lockers, and other fixed delivery locations

List Fixed Locations

GET
/locations/fixedlocations/{country_code}

Get pickup points, lockers, and other fixed delivery locations with optional filtering by locality (ID or name+county), or multiple carriers. Country code is required as a path parameter.

Parameters

Name Type Required Description
country_codestringYesISO 3166-1 alpha-2 country code (e.g., "RO", "BG"). This is a path parameter, not a query parameter. Example: /locations/fixedlocations/RO
locality_idintegerNoFilter by specific locality ID. Alternative to locality_name + county_name combination.
locality_namestringNoFilter by locality name. Must be used together with county_name. Supports flexible matching with diacritics.
county_namestringNoFilter by county name or county code (1-2 chars). Must be used together with locality_name. Examples: "Bucuresti" or "B"
carrier_idstring|integerNoFilter by carrier ID(s). Supports single ID (e.g., "1") or multiple IDs (e.g., "1,2,3"). Examples: ?carrier_id=1 or ?carrier_id=1,2,3

Response Codes

Code Status Description
200SuccessFixed locations list retrieved
400Bad RequestInvalid parameters. Common causes: invalid country_code format (must be 2-letter ISO code), or using locality_name without county_name
404Not FoundLocality not found - The provided locality_name and county_name combination does not exist for the given country_code
401UnauthorizedInvalid or missing API key
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error occurred

Response Format

Field Type Description
idintegerUnique fixed location identifier
fixed_location_typestringType of location (e.g., "locker")
carrier_idintegerCarrier identifier - See carriers table
carrier_namestringCarrier company name
locality_idintegerLocality identifier - See localities endpoint
locality_namestringLocality name
county_idintegerCounty identifier
county_namestringCounty name
country_codestringISO 3166-1 alpha-2 country code - See countries endpoint
namestringLocation name/description
addressstringStreet address
allows_drop_offbooleanWhether drop-off is allowed
is_activebooleanWhether location is currently active
coordinatesobjectGPS coordinates
coordinates.latnumberLatitude coordinate
coordinates.longnumberLongitude coordinate
schedulearrayOperating hours for each day
schedule[].dayintegerDay number (1-7, Monday-Sunday)
schedule[].openingHourstringOpening time (HH:mm format)
schedule[].closingHourstringClosing time (HH:mm format)
payment_typestringAccepted payment type

Response Example

RESPONSEJSON
[
  {
    "id": 427758,
    "fixed_location_type": "locker",
    "carrier_id": 3,
    "carrier_name": "FAN Courier",
    "locality_id": 13891,
    "locality_name": "Sector 1",
    "county_id": 10,
    "county_name": "Bucuresti",
    "country_code": "RO",
    "name": "FANbox Aleea Teisani 274-288",
    "address": "Aleea Teisani 274 288",
    "allows_drop_off": true,
    "is_active": true,
    "coordinates": {
      "lat": 44.53615,
      "long": 26.09172
    },
    "schedule": [
      {
        "day": 1,
        "openingHour": "00:00",
        "closingHour": "23:59"
      },
      {
        "day": 2,
        "openingHour": "00:00",
        "closingHour": "23:59"
      }
    ],
    "payment_type": "Card"
  }
]

Complete API Reference

For interactive testing and additional technical details, visit our complete Swagger documentation.

View in Swagger Documentation

Get Fixed Location by ID

GET
/locations/fixedlocations/{id}

Get detailed information about a specific fixed location by its unique identifier

Parameters

Name Type Required Description
idintegerYesThe unique identifier of the fixed location (e.g., /locations/fixedlocations/427758)

Response Codes

Code Status Description
200SuccessFixed location retrieved
401UnauthorizedInvalid or missing API key
404Not FoundFixed location ID not found
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error occurred

Response Format

Field Type Description
idintegerUnique fixed location identifier
fixed_location_typestringType of location (e.g., "locker")
carrier_idintegerCarrier identifier - See carriers table
carrier_namestringCarrier company name
locality_idintegerLocality identifier - See localities endpoint
locality_namestringLocality name
county_idintegerCounty identifier
county_namestringCounty name
country_codestringISO 3166-1 alpha-2 country code - See countries endpoint
namestringLocation name/description
addressstringStreet address
allows_drop_offbooleanWhether drop-off is allowed
is_activebooleanWhether location is currently active
coordinatesobjectGPS coordinates
coordinates.latnumberLatitude coordinate
coordinates.longnumberLongitude coordinate
schedulearrayOperating hours for each day
schedule[].dayintegerDay number (1-7, Monday-Sunday)
schedule[].openingHourstringOpening time (HH:mm format)
schedule[].closingHourstringClosing time (HH:mm format)
payment_typestringAccepted payment type

Response Example

RESPONSEJSON
{
  "id": 427758,
  "fixed_location_type": "locker",
  "carrier_id": 3,
  "carrier_name": "FAN Courier",
  "locality_id": 13891,
  "locality_name": "Sector 1",
  "county_id": 10,
  "county_name": "Bucuresti",
  "country_code": "RO",
  "name": "FANbox Aleea Teisani 274-288",
  "address": "Aleea Teisani 274 288",
  "allows_drop_off": true,
  "is_active": true,
  "coordinates": {
    "lat": 44.53615,
    "long": 26.09172
  },
  "schedule": [
    {
      "day": 1,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 2,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 3,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 4,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 5,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 6,
      "openingHour": "00:00",
      "closingHour": "23:59"
    },
    {
      "day": 7,
      "openingHour": "00:00",
      "closingHour": "23:59"
    }
  ],
  "payment_type": "Card"
}

Complete API Reference

For interactive testing and additional technical details, visit our complete Swagger documentation.

View in Swagger Documentation