---
title: "Listado de contactos"
method: GET
path: "/contacts"
tags: ["Contactos"]
---

# Listado de contactos

`GET /contacts`

## Request

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

Endpoint que permite consultar los contactos registrados en la aplicación

## Query parameters

- `metadata` boolean
- `start` integer
- `limit` integer
- `order_direction` 'DESC' | 'ASC'
- `order_field` 'id' | 'name' | 'email'
- `query` string
- `identification` string
- `name` string
- `type` 'client' | 'provider'
- `mode` 'simple' | 'advanced'

## Response `200`

Se obtiene listado de contactos

- union
  - 0 (unresolved $ref)
  - 1 (unresolved $ref)
  - 2 (unresolved $ref)
  - 3 (unresolved $ref)
  - 4 (unresolved $ref)
  - 5 (unresolved $ref)
  - 6 (unresolved $ref)
  - 7 (unresolved $ref)
  - 8 (unresolved $ref)
  - 9 (unresolved $ref)
  - 11 (unresolved $ref)
  - 12 (unresolved $ref)
  - 13 (unresolved $ref)
  - 14 (unresolved $ref)
  - 15 (unresolved $ref)
  - 16 (unresolved $ref)
  - 17 (unresolved $ref)

## Other responses

- `400`: Límite sobrepasa valor permitido

---

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