List teams
Retrieve a paginated list of teams.
gigstack Connect: Access other teams using the team parameter.
Query parameters
gigstack Connect: Target team ID for multi-team access.
Requires gigstack Connect enabled on your team and shared billing account.
Example: ?team=team_xyz789
Maximum number of items to return (default 50, max 100)
Pagination cursor for the next page of results
Field name to order results by
Sort direction for list queries
Sort direction for the results
Filter results created on or after this timestamp. Accepts Unix timestamp in seconds (e.g., 1733011200), milliseconds (e.g., 1733011200000), or ISO 8601 date string (e.g., 2024-12-01).
Filter results created on or before this timestamp. Accepts Unix timestamp in seconds (e.g., 1735689599), milliseconds (e.g., 1735689599000), or ISO 8601 date string (e.g., 2024-12-31).
Response
Teams retrieved successfully
Example response
{
"data": [
{
"id": "team_1234567890",
"legal_name": "Empresa de Tecnología S.A. de C.V.",
"address": {
"country": "MEX",
"street": "Av. Insurgentes Sur 456",
"zip": "03100",
"city": "Ciudad de México",
"state": "CDMX",
"exterior": "96",
"interior": "10",
"neighborhood": "Polanco"
},
"brand": {
"alias": "Mi Empresa",
"primary_color": "#007bff",
"secondary_color": "#6c757d",
"logo": "https://example.com/logo.png"
},
"settings": {
"avoid_automations_on_currencies": [
"USD",
"EUR"
],
"default_description": "Default invoice description",
"emails": {
"invoices_bcc": [
"accounting@example.com"
],
"avoid_test_invoice_emails": true
},
"override_item_description": "Custom item description",
"uses_on_self_invoice_portal": [
"G03",
"S01"
],
"invoice_pdf_notes": "Additional notes for PDF",
"product_key": "81112209",
"unit_key": "E48",
"use": "G03",
"automate_complement_for_ppd_invoices": true,
"customer_portal_id": "portal_1234567890",
"periodicity": {
"label": "Mes",
"value": "month"
},
"default_series": {
"income": {
"serie": "A"
},
"complements": {
"serie": "P"
},
"credit_note": {
"serie": "NC"
}
}
},
"tax_id": "EMP800101ABC",
"tax_system": "601",
"support_email": "support@empresa.com",
"support_phone": "+52 55 1234 5678",
"owner": "user_1234567890",
"created_at": 1677651234,
"sat": {
"completed": true,
"connected_at": 1677651234,
"csd_expires_at": 1924991999
},
"members": [
{
"id": "user_1234567890",
"email": "member@empresa.com",
"role": "admin"
}
],
"integrations": {
"stripe": {
"category": "payments"
},
"mercadopago": {
"category": "payments"
},
"clip": {
"category": "payments"
},
"whmcs": {
"category": "payments"
},
"paypal": {
"category": "payments"
},
"openpay": {
"category": "payments"
},
"conekta": {
"category": "payments"
},
"bank": {
"category": "payments"
},
"shopify": {
"category": "payments"
},
"zapier": {
"category": "payments"
},
"airtable": {
"category": "payments"
},
"google_sheets": {
"category": "payments"
},
"hilos": {
"category": "messaging"
}
},
"credit_limit": 1000,
"used_credits": 250,
"credit_period_start": 1677651234000,
"metadata": {
"custom_field": "value"
}
}
],
"next": "team_dmU311Ajzj",
"total_results": 105,
"has_more": true,
"message": "Clients retrieved successfully",
"success": true,
"timestamp": 1768240724433
}