---
title: "Listar estabelecimentos"
method: GET
path: "/v1/marketplace/establishments"
tags: ["Estabelecimentos"]
---

# Listar estabelecimentos

`GET /v1/marketplace/establishments`

## Query parameters

- `filters` string
- `search` string
- `perPage` number
- `page` number
- `sorters` string

## Headers

- `integration-key` string, required
- `x-token` string, required

## Response `200`

- object
  - `total` number, required — Número total de registros.
  - `page` number, required — Página atual.
  - `perPage` number, required — Número de registros por página.
  - `lastPage` number, required — Número total de páginas.
  - `data` EstablishmentsMarketplaceResponse[]
    - `id` number, required — Identificador do estabelecimento.
    - `type` 'INDIVIDUAL' | 'BUSINESS', required — Tipo - BUSINESS: pessoa jurídica. - INDIVIDUAL: pessoa física.
    - `first_name` string, required — Nome / Razão social.
    - `last_name` string, required — Sobrenome / Nome fantasia.
    - `document` string, required — CPF / CNPJ.
    - `birthdate` string, date-time, required — Data de nascimento / Data de abertura.
    - `phone_number` string, required — Número de telefone.
    - `active` boolean, required — Indica se o estabelecimento está credenciado ou não.
    - `revenue` string, required — Faturamento.
    - `format` 'SS' | 'SC' | 'SPE' | 'LTDA' | 'SA' | 'ME' | 'MEI' | 'EI' | 'EIRELI' | 'SLU' | 'ESI' — Formato da empresa.
    - `email` string, required — E-mail.
    - `risk` 'LOW' | 'MEDIUM' | 'HIGH', required — Risco.
    - `status` 'PENDING' | 'VALIDATION' | 'RISK_ANALYSIS' | 'APPROVED' | 'DISAPPROVED' | 'DISCREDITED' | 'DISCREDITED_PERMANENTLY' | 'BACKGROUND_CHECK', required — Status do estabelecimento.
    - `address` Address, required
      - `street` string, required — Logradouro.
      - `number` string, required — Número.
      - `complement` string — Complemento.
      - `neighborhood` string, required — Bairro.
      - `city` string, required — Cidade.
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MS' | 'MT' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required — Estado.
      - `zip_code` string, required — CEP.
    - `category` string, required — Código da categoria comercial (MCC).
    - `code` string, required — Identificador alfanumérico único do estabelecimento
    - `created_at` string, date-time, required — Data de criação.
    - `updated_at` string, date-time, required — Data da última atualização.
    - `deleted_at` string, date-time, required — Data de exclusão.

---

[API](https://skmtc.net/paytime/apis/api-p-blica.md) · [All operations](https://skmtc.net/paytime/apis/api-p-blica/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paytime/api-p-blica/revisions/5c818991d183/schema)