Should you notice any errors in our documentation, please don’t hesitate to contact us. Thank you!
List
GET
https://www-staging.givve.com/api/merchant_locations
Last modified:2025-06-11 10:32:47
MerchantLocations List
Filterable Attributes
| Attribute Name | Meaning |
|---|---|
| merchant_id | Id of merchant, whose locations are to be displayed |
| postal_code_area | first two digits of the postal code of the merchant location. Only german postal codes are currently supported |
Accessible By
Parameters:
| name | type | default | info |
|---|---|---|---|
| sort | string | NONE | OPTIONAL, defaults to created_at |
| skip_meta_totals | boolean | false | OPTIONAL, defaults to false |
| page[number] integer/string | 1 | OPTIONAL, defaults to 1 | |
| page[size] | integer/string | 25 | OPTIONAL, default page size is 25, max page size is 250 |
Return
{
"meta": {
"total_pages": 0,
"current_page": 0,
"page_size": 0,
"total_entries": 0
},
"data": [
{
"id": "string",
"created_at": "2022-01-27T09:15:25.613+01:00",
"updated_at": "2022-05-02T10:01:34.252+02:00",
"merchant_id": "string",
"name": "string",
"address_line": "string",
"location_point": {
"longitude": 1.2,
"latitude": 34.5
},
"postal_data": {
"id": "string",
"postal_code": "12345",
"town_name": {
"de": "string"
},
"town_name_affix": null,
"display_name": {
"de": "string"
},
"postal_code_area": "88",
"associated_postal_code_areas": [
"11",
"12",
"13"
],
"associated_districts": []
}
}
],
"links": {
"self": "http://example.com",
"first": "http://example.com",
"prev": "http://example.com",
"next": "http://example.com",
"last": "http://example.com"
}
}Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www-staging.givve.com/api/merchant_locations' \
--header 'Authorization: Bearer ' \
--header 'Accept-Version: v2'Response Response Example
{}Request
Header Params
Authorization
string
required
Example:
Bearer {{token}}
Accept-Version
string
required
Example:
v2
Responses
Modified at 2025-06-11 10:32:47