List clients

GET

https://api.gigstack.io/v2/clients

Retrieve a paginated list of clients.

gigstack Connect: Access other teams' clients using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Responses

🟢200Correcto

application/json

Clients retrieved successfully

Body

🟠401No autenticado

🟠403Permiso insuficiente

🔴500Error interno del servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.gigstack.io/v2/clients?team&limit&next&order_by&sort&created' \
--header 'Authorization: <api-key>'

Response Example

200 - Éxito

{
    "message": "Clients retrieved successfully",
    "data": [
        {
            "id": "client_1234567890",
            "name": "Juan Pérez García",
            "email": "juan.perez@ejemplo.com",
            "tax_id": "PEGJ800101ABC",
            "tax_system": "601",
            "legal_name": "Juan Pérez García",
            "address": {
                "street": "Av. Insurgentes Sur 123",
                "zip": "03100",
                "city": "Ciudad de México",
                "state": "CDMX",
                "country": "MEX"
            },
            "is_valid": true,
            "livemode": true,
            "created_at": 1677651234,
            "team": "team_1234567890",
            "owner": "user_1234567890"
        }
    ],
    "has_more": false,
    "total_results": 1
}

Modified at 2025-10-09 23:51:05

Clients API Guide

Get client