Direct API
Billing Addresses
Retrieve paginated list of billing addresses
GET
/addresses/billing
Retrieve a paginated list of billing 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 | Billing 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 billing 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[].street_name | string | Street name |
| list[].street_no | string | Street number |
| list[].zipcode | string | Postal code |
| list[].company | string | Company name (business addresses only) |
| list[].vat_no | string | VAT number (business addresses only) |
| list[].reg_com | string | Commercial registry number (business addresses only) |
| list[].vat_payer | string | VAT payer status (business addresses only) |
| list[].cnp | string | Personal numeric code (individual addresses only) |
| list[].bank_iban | string | Bank IBAN |
| list[].bank | string | Bank name |
| 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 billing address |
| list[].locality_name | string | Full locality name with county |
| list[].county_id | integer | County identifier |
| list[].county_code | string | County code |
| list[].county_name | string | County name |
| 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": 85,
"address_type": "business",
"country_code": "RO",
"locality_id": 13893,
"street_id": 50235,
"street_name": "Strada Industriei",
"street_no": "789",
"street_details": "Floor 3, Office 5",
"zipcode": "032067",
"company": "Tech Solutions SRL",
"vat_no": "RO12345678",
"reg_com": "J40/123/2023",
"vat_payer": "yes",
"bank_iban": "RO49AAAA1B31007593840000",
"bank": "Banca Transilvania",
"contact": "Maria Popescu",
"phone": "0721234567",
"email": "maria.popescu@example.com",
"is_default": true,
"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"
},
{
"id": 92,
"address_type": "individual",
"country_code": "RO",
"locality_id": 8178,
"street_id": null,
"street_name": "Personal Street",
"street_no": "456",
"street_details": null,
"zipcode": "077016",
"cnp": "1234567890123",
"bank_iban": "RO49BBBB1B31007593840000",
"bank": "BCR",
"contact": "Alex Johnson",
"phone": "0721234567",
"email": "alex.johnson@example.com",
"is_default": false,
"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"
}
],
"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
