Direct API
Delivery Addresses
Retrieve paginated list of delivery addresses
GET
/addresses/delivery
Retrieve a paginated list of delivery addresses with optional pagination parameters. Use 'all=true' to get all addresses without pagination.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number for pagination (default: 1) |
| per_page | number | No | Number of addresses per page (options: 15, 50, 100, 200, default: 15) |
| all | boolean | No | Return all addresses without pagination when set to true (default: false) |
Response Codes
| Code | Status | Description |
|---|---|---|
| 200 | Success | Delivery addresses retrieved |
| 401 | Unauthorized | Invalid or missing API key |
| 422 | Validation Error | Invalid per_page value. Allowed values are: 15, 50, 100, 200 |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error occurred |
Response Format
| Field | Type | Description |
|---|---|---|
| list | array | Array of delivery address objects |
| list[].id | integer | Unique address identifier |
| list[].address_type | string | Type of address (individual, business) |
| list[].country_code | string | Country code (ISO 2-letter) |
| list[].locality_id | integer | Locality identifier |
| list[].contact | string | Contact person name |
| list[].phone | string | Contact phone number |
| list[].email | string | Contact email address |
| list[].is_default | boolean | Whether this is the default delivery address |
| meta | object | Pagination metadata |
| meta.total | integer | Total number of addresses |
| meta.current_page | integer | Current page number |
| meta.per_page | integer | Items per page |
| meta.last_page | integer | Last page number |
Response Example
RESPONSEJSON
{
"list": [
{
"id": 120,
"address_type": "individual",
"country_code": "RO",
"locality_id": 8178,
"street_id": null,
"street_name": "Main Street",
"street_no": "123",
"street_details": null,
"zipcode": "077016",
"contact": "John Smith",
"phone": "0721234567",
"email": "john.smith@example.com",
"is_default": true,
"created_at": "2025-05-29T15:41:57.000000Z",
"updated_at": "2025-06-23T21:02:17.000000Z",
"coordinates": {
"lat": 44.6359645,
"lng": 26.1156689
},
"locality_name": "Dumbraveni (Ilfov)",
"county_id": 26,
"county_code": "IF",
"county_name": "Ilfov"
},
{
"id": 115,
"address_type": "business",
"country_code": "RO",
"locality_id": 13893,
"street_id": 50235,
"street_name": "Bulevardul Unirii",
"street_no": "123",
"street_details": "Office Building",
"zipcode": "032067",
"company_name": "Tech Solutions Ltd",
"contact": "Jane Doe",
"phone": "0721234567",
"email": "jane.doe@example.com",
"is_default": false,
"created_at": "2025-05-19T07:52:23.000000Z",
"updated_at": "2025-06-23T21:02:17.000000Z",
"locality_name": "Bucuresti (Sector 3)",
"county_id": 10,
"county_code": "B",
"county_name": "Bucuresti"
}
],
"meta": {
"total": 2,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"from": 1,
"to": 2
}
}Complete API Reference
For interactive testing and additional technical details, visit our complete Swagger documentation.
View in Swagger Documentation
