Skip to content

The Addresses API allows users to manage their saved addresses, which can be used for orders and deliveries.

Endpoint:

GET /v1/addresses

Required Headers:

json
{
  "Authorization": "Bearer JWT_TOKEN",
  "X-MerchantApiKey": "MERCHANT_API_KEY"
}

Query Parameters:

ParameterTypeRequiredDescription
limitintNoNumber of addresses to retrieve.
pageintNoPagination number.

Example API Call (Fetch or Axios)

javascript
fetch('https://api.shopsynch.com/v1/addresses', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer JWT_TOKEN',
    'X-MerchantApiKey': 'MERCHANT_API_KEY'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Sample 200 Response:

json
{
  "data": [
    {
      "id": "1",
      "street": "123 Main St",
      "streetNumber": "12A",
      "postalCode": "100001",
      "city": "Lagos",
      "state": "Lagos",
      "country": "Nigeria",
      "localGovernmentName": "Ikeja",
      "isDefault": false
    }
  ],
  "message": "Addresses retrieved successfully",
  "status": true
}

Next Steps

Build with joy