Get providers

GET

/v3/api/business/reseller/providers

Returns a paginated list of wellness providers, optionally filtered by category and geographic proximity.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

*/*

Paginated list of providers

Body*/*

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/providers?latitude=6.5244&longitude=3.3792&category=SPA&starting_after=undefined&ending_before=undefined&limit=10' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "object": "list",
    "data": [
        {
            "object": "provider",
            "id": "prov_abc123",
            "name": "Zen Wellness Spa",
            "category": "SPA",
            "address": "12 Marina Road, Lagos Island, Lagos",
            "coordinates": {
                "lat": 6.455,
                "lng": 3.4236
            },
            "distance_km": 2.4,
            "phone": "+2349012345678",
            "services": [
                {
                    "service_category": {
                        "id": 12,
                        "category": "Massage"
                    },
                    "service_offerings": [
                        {
                            "id": "srv_abc123",
                            "name": "Deep Tissue Massage",
                            "description": "60-minute full body massage",
                            "price": 25000,
                            "currency": "NGN",
                            "estimated_duration": 60,
                            "credit_cost": 5,
                            "service_tier": {
                                "id": 4,
                                "tier": "TIER_2"
                            }
                        },
                        {
                            "id": "srv_def456",
                            "name": "Swedish Massage",
                            "description": "45-minute relaxing massage",
                            "price": 15000,
                            "currency": "NGN",
                            "estimated_duration": 45,
                            "credit_cost": 3,
                            "service_tier": {
                                "id": 3,
                                "tier": "TIER_1"
                            }
                        }
                    ]
                }
            ],
            "created": 1746700000000
        }
    ],
    "has_more": true,
    "url": "/v3/api/business/reseller/providers",
    "message": "Providers retrieved successfully"
}

Modified at 2026-05-21 13:30:24

Introduction

Get providers for a pass