> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pictum.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API overview

> Understand Pictum API paths, response behavior, and errors.

The v1 API serves a public icon catalog, deterministic avatars, QR codes, and placeholders.

## Base URL

Send all API requests to the production base URL:

```text theme={null}
https://pictum.dev/v1/...
```

## Response behavior

Successful image responses include:

* A format-specific `Content-Type`.
* `X-Content-Type-Options: nosniff`.
* Public `Cache-Control` directives.
* An `ETag` exposed through CORS.
* `Access-Control-Allow-Origin: *` for browser consumers.

SVG responses also include a restrictive Content Security Policy.

## Errors

| Status | Meaning                                                 |
| ------ | ------------------------------------------------------- |
| `404`  | A route constraint or requested resource did not match  |
| `422`  | Avatar, QR code, or placeholder input failed validation |
| `503`  | The icon catalog is unavailable                         |

Use the generated endpoint pages in this section for parameter and response details.