List import runs
Returns import runs accessible to the API key’s account.
GET
/api/v1/import/runsimport: read1,000 requests/minute/key · all plansActive API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | Optional | Filter or option: limit. Minimum: 1. Maximum: 100. |
Response schema
200
Successful response.
| Name | Type | Required | Description |
|---|---|---|---|
_id | string | Required | Unique identifier. |
userId | string | Required | Owning account identifier. |
status | string | Required | Status. |
startedAt | number | Required | Started At. |
finishedAt | number | Optional | Finished At. |
summary | object | Required | Summary. |
summary.directories | object | Required | Directories. |
summary.directories.created | number | Required | Created. |
summary.directories.skipped | number | Required | Skipped. |
summary.directories.failed | number | Required | Failed. |
summary.directories.updated | number | Optional | Updated. |
summary.members | object | Required | Members. |
summary.members.created | number | Required | Created. |
summary.members.skipped | number | Required | Skipped. |
summary.members.failed | number | Required | Failed. |
summary.members.updated | number | Optional | Updated. |
summary.members.archived | number | Optional | Archived. |
summary.entries | object | Required | Entries. |
summary.entries.created | number | Required | Created. |
summary.entries.skipped | number | Required | Skipped. |
summary.entries.failed | number | Required | Failed. |
summary.entries.updated | number | Optional | Updated. |
summary.frontSessions | object | Required | Front Sessions. |
summary.frontSessions.created | number | Required | Created. |
summary.frontSessions.skipped | number | Required | Skipped. |
summary.frontSessions.failed | number | Required | Failed. |
summary.frontSessions.updated | number | Optional | Updated. |
summary.memberStatuses | object | Optional | Member Statuses. |
summary.memberStatuses.created | number | Required | Created. |
summary.memberStatuses.skipped | number | Required | Skipped. |
summary.memberStatuses.failed | number | Required | Failed. |
summary.memberStatuses.updated | number | Optional | Updated. |
summary.memberStatuses.avatarsImported | number | Optional | Avatars Imported. |
summary.memberStatuses.avatarsFailed | number | Optional | Avatars Failed. |
summary.memberStatuses.failureReasons | object | Optional | Failure Reasons. |
summary.media | object | Optional | Media. |
summary.media.avatars | object | Optional | Avatars. |
summary.media.backgrounds | object | Optional | Backgrounds. |
summary.media.skippedReason | string | Optional | Skipped Reason. Set when MinIO probe fails — import continues without re-hosting images. |
summary.simplyPluralAvatarFailures | array<object> | Optional | Simply Plural Avatar Failures. |
summary.simplyPluralAvatarFailures[].sourceMemberId | string | Required | Source Member Id. |
summary.simplyPluralAvatarFailures[].name | string | Required | Name of the resource. |
summary.simplyPluralAvatarFailures[].reason | string | Optional | Reason. |
errorMessage | string | Optional | Error Message. |
progressPhase | string | Optional | Progress Phase. |
progressPercent | number | Optional | Progress Percent. |
progressDetail | string | Optional | Progress Detail. |
targetSideSystemId | null | string | Optional | Target Side System Id. |
targetSubSystemId | null | string | Optional | Target Sub System Id. |
Errors
400· JSON errorRequest failed (BAD_REQUEST).
401· JSON errorMissing or invalid API key. Use Authorization: Bearer <token>.
403· JSON errorRequires import: read; ownership or feature restrictions may also deny access.
429· JSON errorAPI rate limit exceeded (1000 requests per minute). Retry shortly.
503· JSON errorPostgreSQL is not configured (DATABASE_URL).
Request example
Set FLORALITY_KEY in your environment. These examples use demo identifiers.
curl --request GET 'https://floralitys.com/api/v1/import/runs' \
--header "Authorization: Bearer $FLORALITY_KEY"Responses
Successful response.
[
{
"_id": "11111111-1111-4111-8111-111111111111",
"userId": "11111111-1111-4111-8111-111111111111",
"status": "demo",
"startedAt": 1767225600000,
"finishedAt": 1767225600000,
"summary": {
"directories": {
"created": 0,
"skipped": 0,
"failed": 0,
"updated": 0
},
"members": {
"created": 0,
"skipped": 0,
"failed": 0,
"updated": 0,
"archived": 0
},
"entries": {
"created": 0,
"skipped": 0,
"failed": 0,
"updated": 0
},
"frontSessions": {
"created": 0,
"skipped": 0,
"failed": 0,
"updated": 0
},
"memberStatuses": {
"created": 0,
"skipped": 0,
"failed": 0,
"updated": 0,
"avatarsImported": 0,
"avatarsFailed": 0,
"failureReasons": {}
},
"media": {
"avatars": {
"attempted": 0,
"succeeded": 0,
"failed": 0
},
"backgrounds": {
"attempted": 0,
"succeeded": 0,
"failed": 0
},
"skippedReason": "demo"
},
"simplyPluralAvatarFailures": [
{
"sourceMemberId": "11111111-1111-4111-8111-111111111111",
"name": "River",
"reason": "demo"
}
]
},
"errorMessage": "demo",
"progressPhase": "demo",
"progressPercent": 0,
"progressDetail": "demo",
"targetSideSystemId": null,
"targetSubSystemId": null
}
]Example values are illustrative demo data.