---
title: "Get the user's most recent creations"
method: GET
path: "/v1/creations/recent"
tags: ["Creations"]
---

# Get the user's most recent creations

`GET /v1/creations/recent`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/creations/recent`
- Auth: API key in header `x-magnific-api-key`

Returns the most recent files (creations) belonging to the user identified by the API key, enriched with the metadata of the creation that produced each file. Results are paginated and ordered from newest to oldest.

## Query parameters

- `per_page` integer
- `page` integer
- `tool_name` string

## Response `200`

OK Response

- GetRecentCreations200Response
  - `data` RecentCreation[]
    - `id` integer: The ID of the file.
    - `reference` string, uuid: Reference id of the file.
    - `user_id` integer: The ID of the owner user.
    - `folder_id` integer, nullable: The id of the folder where the file is located.
    - `folder_reference` string, uuid, nullable: The reference of the folder where the file is located.
    - `name` string: The name of the file.
    - `external_id` string, nullable: The ID of the file on the external tool (creation id).
    - `thumbnail` RecentCreationThumbnail, nullable: Thumbnail of the file.
      - `url` string, uri
    - `tool_name` string, nullable: The tool that produced the file.
    - `created_at` string, date-time: The date when the file was created.
    - `updated_at` string, date-time: The date when the file was updated.
    - `creation` Creation, nullable: Metadata of the creation that produced the file. Present only when the file is linked to a creation owned by the user.
      - `id` integer
      - `identifier` string: Public short identifier of the creation.
      - `family` string, nullable
      - `tool` string
      - `url` string, uri, nullable: Temporary URL of the creation media.
      - `raw` string, uri, nullable: Temporary URL of the raw (original) media.
      - `preview` string, uri, nullable: Temporary URL of the preview media.
      - `large_preview` string, uri, nullable: Temporary URL of the large preview media.
      - `public` boolean
      - `nsfw` boolean
      - `status` string
      - `user_id` integer
      - `created_at` string, date-time
      - `metadata` object, nullable: Tool-specific metadata of the creation.
  - `meta` GetRecentCreations200ResponseMeta
    - `pagination` Pagination: Metainformation about pagination
      - `current_page` integer: The current page.
      - `per_page` integer: The limit of resources per page.
      - `last_page` integer: The total number of pages.
      - `total` integer: The total number of resources.

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `403`: Forbidden - The client does not have permission to access the requested resource.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

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