---
title: "Listar clientes"
method: GET
path: "/v1/accountingfirms/{accountingFirmId}/customers"
---

# Listar clientes

`GET /v1/accountingfirms/{accountingFirmId}/customers`

Permite obter uma lista paginada de até 100 clientes vinculados a um escritório contábil, com suporte a OData.

## Path parameters

- `accountingFirmId` string, required

## Query parameters

- `$filter` string
- `$skip` string
- `$top` string
- `$orderby` string

## Headers

- `X-API-Key` string
- `X-User-Id` string

## Response `200`

200

- object
  - `items` object[]
    - `id` string
    - `name` string
    - `isOwnAccountant` string
    - `code` string
    - `niboDocsEnabled` string
    - `address` object
      - `city` string
      - `state` string
      - `street` string
      - `number` string
      - `complement` string
      - `district` string
      - `postalCode` string
    - `documentNumber` string
    - `documentType` string
    - `taxRegime` string
    - `businessActivity` string
    - `cei` string
    - `caepf` string
    - `stateRegistration` string
    - `cityRegistration` string
    - `createdAt` string
    - `createdBy` string
    - `inactiveDate` string
    - `inactiveUser` string
    - `updatedAt` string
    - `updatedBy` string
  - `metadata` object
    - `totalAllItems` string
    - `total` string

## Other responses

- `401` — 401
- `403` — 403
- `500` — 500

---

[API](https://skmtc.net/nibo/apis/api-empresa.md) · [All operations](https://skmtc.net/nibo/apis/api-empresa/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nibo/api-empresa/revisions/9492ac98cb75/schema)