---
title: "List random profiles"
method: GET
path: "/v1/profiles"
---

# List random profiles

`GET /v1/profiles`

## Request

- Base URL: `https://random-profiles.com`
- URL: `https://random-profiles.com/v1/profiles`
- Auth: API key in header `X-API-Key`

## Query parameters

- `count` integer
- `photo_size` 64 | 128 | 256 | 512 | 1024
- `photo_format` 'jpg' | 'webp'
- `fields` string
- `gender` 'male' | 'female' | 'non-binary'
- `country` string
- `exclude_country` string
- `min_age` integer
- `max_age` integer
- `seed` integer
- `format` 'json' | 'csv'

## Response `200`

List of profiles

## Other responses

- `401`: Invalid or missing API key
- `429`: Daily limit reached. Body includes support_url (buy a coffee for unlimited access).

---

[API](https://skmtc.dev/random-profiles/apis/random-profiles-api.md) · [All operations](https://skmtc.dev/random-profiles/apis/random-profiles-api/llms.txt) · [OpenAPI document](https://skmtc.dev/random-profiles/apis/random-profiles-api/revisions/ccbd86a234e6?raw)