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

# Creations API

> Retrieve your most recent AI creations programmatically with the Magnific Creations API.

<Card title="Recent creations" icon="wand-magic-sparkles">
  Programmatic access to the most recent creations of the user behind your API key.
</Card>

The Creations API lets you retrieve a user's most recent creations — the files they have generated — enriched with the metadata of the creation that produced each one. Use it to surface a user's latest work in your own app, dashboards, or galleries.

It does not consume credits.

## Recent creations

Fetch the most recent creations with [`GET /v1/creations/recent`](/api-reference/creations/recent-creations). Results are paginated and ordered from newest to oldest. The identity is resolved automatically from the API key — you always get the creations of that key's user.

```bash theme={null}
curl https://api.magnific.com/v1/creations/recent?per_page=3 \
  -H "X-Magnific-API-Key: YOUR_API_KEY"
```

### Example response

```json theme={null}
{
  "data": [
    {
      "id": 1337,
      "reference": "4fef9987-75d0-44d1-b336-65f42f883bff",
      "user_id": 159327,
      "name": "My awesome creation",
      "external_id": "8421",
      "tool_name": "text-to-image",
      "thumbnail": { "url": "https://cdn.freepik.com/thumbnails/8421.jpg" },
      "created_at": "2026-05-01T12:30:00Z",
      "updated_at": "2026-05-01T12:30:00Z",
      "creation": {
        "id": 8421,
        "identifier": "a1b2c3d4",
        "family": "image",
        "tool": "text-to-image",
        "url": "https://cdn.freepik.com/creations/8421.png",
        "preview": "https://cdn.freepik.com/creations/8421-preview.png",
        "status": "completed",
        "public": false,
        "nsfw": false,
        "user_id": 159327,
        "created_at": "2026-05-01T12:30:00Z"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "per_page": 3
    }
  }
}
```

### Query parameters

| Parameter   | Description                                                          | Default |
| ----------- | -------------------------------------------------------------------- | ------- |
| `page`      | Page number to retrieve                                              | `1`     |
| `per_page`  | Number of creations per page                                         | `5`     |
| `tool_name` | Filter by the tool that produced the creation (e.g. `text-to-image`) | —       |

## Authentication

Authenticate with the `X-Magnific-API-Key` header. The user is identified automatically from the API key — you cannot request another user's creations. See [Authentication](/authentication) for details.

## Rate limits

The endpoint is limited to **300 requests per minute** (300 RPM) per API key. Exceeding it returns `429 Too Many Requests`.

## API reference

<div className="my-11">
  <Columns cols={2}>
    <Card title="Recent Creations" icon="wand-magic-sparkles" href="/api-reference/creations/recent-creations">
      List the user's most recent creations, newest first
    </Card>
  </Columns>
</div>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Whose creations does it return?">
    Always the creations of the user associated with the API key. Identity is resolved server-side from the key, so a client cannot request another user's creations.
  </Accordion>

  <Accordion title="Does it consume credits?">
    No. The Creations API is a read-only endpoint and does not consume credits.
  </Accordion>

  <Accordion title="How do I paginate?">
    Use the `page` and `per_page` query parameters. The response `meta.pagination` block reflects the current page and page size.
  </Accordion>

  <Accordion title="Can I filter by tool?">
    Yes. Pass `tool_name` (for example `text-to-image`) to return only the creations produced by that tool.
  </Accordion>
</AccordionGroup>