Skip to main content

Recent creations

Programmatic access to the most recent creations of the user behind your API key.
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. 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. 
curl https://api.magnific.com/v1/creations/recent?per_page=3 \
  -H "X-Magnific-API-Key: YOUR_API_KEY"

​
Example response

{
  "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

ParameterDescriptionDefault
pagePage number to retrieve1
per_pageNumber of creations per page5
tool_nameFilter 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 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

Recent Creations

List the user’s most recent creations, newest first

​
Frequently Asked Questions

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.
No. The Creations API is a read-only endpoint and does not consume credits.
Use the page and per_page query parameters. The response meta.pagination block reflects the current page and page size.
Yes. Pass tool_name (for example text-to-image) to return only the creations produced by that tool.