> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timbrix.mx/llms.txt
> Use this file to discover all available pages before exploring further.

# List Customers

Returns all customers belonging to an organization.

## Authentication

Requires a valid Bearer token. The authenticated user must be a member of the organization.

## Path Parameters

| Parameter        | Type          | Required | Description     |
| ---------------- | ------------- | -------- | --------------- |
| `organizationId` | string (UUID) | Yes      | Organization ID |

## Example Request

```bash theme={null}
curl -X GET http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/customers \
  -H "Authorization: Bearer <your_token>"
```

## Example Response

```json theme={null}
[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "legalName": "Dunder Mifflin",
    "taxId": "DUM901231AB3",
    "taxSystem": "601",
    "email": "billing@dundermifflin.com",
    "phone": "6474010101",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "interior": null,
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX"
    },
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]
```

## Common Errors

### 401 Unauthorized

Authentication required.

### 403 Forbidden

User is not a member of this organization.


## OpenAPI

````yaml GET /organizations/{organizationId}/customers
openapi: 3.1.0
info:
  title: Timbrix API
  description: >-
    REST API with OAuth2 server for managing organizations, members, and
    webhooks
  version: '1.0'
  contact: {}
servers:
  - url: http://sandbox.mintlify.com
    description: Sandbox environment
  - url: http://localhost:3001/api
    description: Local development
security: []
tags:
  - name: organizations
    description: Organization management endpoints
  - name: oauth
    description: OAuth2 authentication and authorization
  - name: webhooks
    description: Webhook configuration and delivery
  - name: users
    description: User information endpoints
  - name: api-keys
    description: API Keys management and validation
paths:
  /organizations/{organizationId}/customers:
    get:
      tags:
        - customers
      summary: List all customers for an organization
      operationId: CustomersController_list
      parameters:
        - name: organizationId
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CustomerResponseDto'
      security:
        - bearer: []
components:
  schemas:
    CustomerResponseDto:
      type: object
      properties:
        id:
          type: string
          example: 590ce6c56d04f840aa8438af
        organizationId:
          type: string
          example: org-uuid
        legalName:
          type: string
          example: Dunder Mifflin
        taxId:
          type: string
          example: ABC101010111
        taxSystem:
          type: string
          example: '601'
        email:
          type: string
          example: email@example.com
        phone:
          type: object
          example: '6474010101'
        defaultInvoiceUse:
          type: string
          example: G01
        address:
          $ref: '#/components/schemas/CustomerAddressDto'
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
      required:
        - id
        - organizationId
        - legalName
        - taxId
        - taxSystem
        - email
        - defaultInvoiceUse
        - address
        - createdAt
        - updatedAt
    CustomerAddressDto:
      type: object
      properties:
        street:
          type: string
          example: Blvd. Atardecer
        exterior:
          type: string
          example: '142'
        interior:
          type: object
          example: '4'
        neighborhood:
          type: string
          example: Centro
        city:
          type: string
          example: Huatabampo
        municipality:
          type: string
          example: Huatabampo
        zip:
          type: string
          example: '86500'
        state:
          type: string
          example: Sonora
        country:
          type: string
          example: MEX
      required:
        - street
        - exterior
        - neighborhood
        - city
        - municipality
        - zip
        - state
        - country
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````