---
title: "Listar representantes"
method: GET
path: "/v1/marketplace/representatives"
tags: ["Representantes"]
---

# Listar representantes

`GET /v1/marketplace/representatives`

## 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` RepresentativeResponseDto[]
    - `id` number, required — Identificador do representante.
    - `active` boolean, required — Indica se está ativo.
    - `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.
    - `states` RepresentativeStates[], required — Estados de atuação do representante.
      - `id` number, required — Identificador do estado.
      - `initials` string, required — Iniciais do estado
      - `name` string, required — Nome do estado.
    - `establishment` EstablishmentRepresentativeResponse, required
      - `first_name` string, required — Nome / razão social.
      - `last_name` string, required — Sobrenome / nome fantasia.
      - `document` string, required — CPF / CNPJ.
      - `owner` EstablishmentOwner, required
        - `first_name` string, required — Nome / razão social.
        - `last_name` string, required — Sobrenome / nome fantasia.
        - `document` string, required — CPF / CNPJ.
    - `royalties` RepresentativeRoyalties, required
      - `pix` number, required — Royaltie do pix.
      - `ted` number, required — Royaltie do ted.
      - `debit` number, required — Royaltie do débito.
      - `billet` number, required — Royaltie do boleto.
      - `credit` number, required — Royaltie do crédito.

---

[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)