---
title: "Endpoint para consultar vendedores"
method: GET
path: "/sellers"
tags: ["Consultar todos los vendedores"]
---

# Endpoint para consultar vendedores

`GET /sellers`

## Request

- Base URL: `https://api.alegra.com/api/v1`
- URL: `https://api.alegra.com/api/v1/sellers`
- Auth: HTTP basic

Endpoint que permite consultar todos los vendedores asociados a la empresa

## Query parameters

- `start` integer
- `limit` integer
- `status` string[]

## Response `200`

Operación exitosa

- Seller[]
  - `id` string: Identificador único que representa un vendedor específico. La aplicación lo asigna automáticamente.
  - `name` string, required: Nombre del vendedor.
  - `identification` string: Número de identificación del vendedor.
  - `observations` string: Observaciones del vendedor.
  - `status` 'active' | 'inactive': Estado del vendedor. Las opciones posibles son active => El vendedor se encuentra activo. inactive => El vendedor se encuentra inactivo.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/alegra/apis/vendedores.md) - [All operations](https://skmtc.dev/alegra/apis/vendedores/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/vendedores/revisions/67d97eaed266?raw)