# List leads

> GET /leads. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/crm/get-leads-list-leads

GET https://server.heyrik.com/api/v1/leads

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- stage (string): Filter by pipeline stage.
- folder_id (string): Only this folder.
- search (string): Match name / company / phone.
- limit (number): Page size.

## Request example

```sh
curl "https://server.heyrik.com/api/v1/leads?stage=qualified&limit=50" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"
```