Direct API
Fixed Locations
Get pickup points, lockers, and other fixed delivery locations
List Fixed Locations
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_code | string | Yes | ISO 3166-1 alpha-2 country code (e.g., "RO", "BG"). This is a path parameter, not a query parameter. Example: /locations/fixedlocations/RO |
| locality_id | integer | No | Filter by specific locality ID. Alternative to locality_name + county_name combination. |
| locality_name | string | No | Filter by locality name. Must be used together with county_name. Supports flexible matching with diacritics. |
| county_name | string | No | Filter by county name or county code (1-2 chars). Must be used together with locality_name. Examples: "Bucuresti" or "B" |
| carrier_id | string|integer | No | Filter 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 |
|---|---|---|
| 200 | Success | Fixed locations list retrieved |
| 400 | Bad Request | Invalid parameters. Common causes: invalid country_code format (must be 2-letter ISO code), or using locality_name without county_name |
| 404 | Not Found | Locality not found - The provided locality_name and county_name combination does not exist for the given country_code |
| 401 | Unauthorized | Invalid or missing API key |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error occurred |
Response Format
| Field | Type | Description |
|---|---|---|
| id | integer | Unique fixed location identifier |
| fixed_location_type | string | Type of location (e.g., "locker") |
| carrier_id | integer | Carrier identifier - See carriers table |
| carrier_name | string | Carrier company name |
| locality_id | integer | Locality identifier - See localities endpoint |
| locality_name | string | Locality name |
| county_id | integer | County identifier |
| county_name | string | County name |
| country_code | string | ISO 3166-1 alpha-2 country code - See countries endpoint |
| name | string | Location name/description |
| address | string | Street address |
| allows_drop_off | boolean | Whether drop-off is allowed |
| is_active | boolean | Whether location is currently active |
| coordinates | object | GPS coordinates |
| coordinates.lat | number | Latitude coordinate |
| coordinates.long | number | Longitude coordinate |
| schedule | array | Operating hours for each day |
| schedule[].day | integer | Day number (1-7, Monday-Sunday) |
| schedule[].openingHour | string | Opening time (HH:mm format) |
| schedule[].closingHour | string | Closing time (HH:mm format) |
| payment_type | string | Accepted payment type |
Response Example
[
{
"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 DocumentationGet Fixed Location by ID
Get detailed information about a specific fixed location by its unique identifier
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | The unique identifier of the fixed location (e.g., /locations/fixedlocations/427758) |
Response Codes
| Code | Status | Description |
|---|---|---|
| 200 | Success | Fixed location retrieved |
| 401 | Unauthorized | Invalid or missing API key |
| 404 | Not Found | Fixed location ID not found |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error occurred |
Response Format
| Field | Type | Description |
|---|---|---|
| id | integer | Unique fixed location identifier |
| fixed_location_type | string | Type of location (e.g., "locker") |
| carrier_id | integer | Carrier identifier - See carriers table |
| carrier_name | string | Carrier company name |
| locality_id | integer | Locality identifier - See localities endpoint |
| locality_name | string | Locality name |
| county_id | integer | County identifier |
| county_name | string | County name |
| country_code | string | ISO 3166-1 alpha-2 country code - See countries endpoint |
| name | string | Location name/description |
| address | string | Street address |
| allows_drop_off | boolean | Whether drop-off is allowed |
| is_active | boolean | Whether location is currently active |
| coordinates | object | GPS coordinates |
| coordinates.lat | number | Latitude coordinate |
| coordinates.long | number | Longitude coordinate |
| schedule | array | Operating hours for each day |
| schedule[].day | integer | Day number (1-7, Monday-Sunday) |
| schedule[].openingHour | string | Opening time (HH:mm format) |
| schedule[].closingHour | string | Closing time (HH:mm format) |
| payment_type | string | Accepted payment type |
Response Example
{
"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
